Modules
Open Online Store → Themes and edit Atölye. Choose the template from the top selector. Product blocks belong inside Products → Default product → Product, including its nested groups. Page sections are added to the template body. Save and preview with real product data.
Although the shared base makes modules optional, Atölye's product template already includes Compare button, Volume pricing, Vehicle fitment, Documents and Back in stock. Check existing blocks before adding duplicates. Custom data setup is in Product data.
Compare
Customers select products, open a comparison table, and optionally show only differences. Specs come from lilya.specs. The selection is saved in the browser.
- Create a page under Online Store → Pages and assign the compare theme template (available when this theme's templates are available in admin). The supplied
page.compare.jsoncontains Product comparison. - In the theme editor, open Footer → Comparison tray and select that page. Set an optional heading and a product limit of 2–4 (default 4). Both preset footers already include the tray.
- Enable Theme settings → Atölye product cards → Show compare toggle for Atölye cards. The product template includes Compare button; its maximum should match the tray limit.
- On the compare page template, edit Product comparison to set its heading and the link shown for an empty selection.
The selected page must actually exist; the supplied compare reference does not create it. The separate Bar comparison section uses manually entered values and is independent of this module.
Quick order
A quantity table shows variants, prices and stock. Quantities represent the desired cart quantities, not additional quantities on each edit. With JavaScript, edits save as customers type; without it, customers submit Update cart. Quantity rules are checked, and prices/totals refresh from Shopify.
- For a collection, add Quick order list to the body of a page or home template. Choose Collection (defaults to all products), Heading, Products per page (5–50, steps of 5; default 20), Show add by SKU, and Show images. The Atölye preset's listing layout already includes this section for spare parts.
- For one product, add Quick order inside the Product section. Set Heading and Show images. This block appears for products with variant options and renders up to 250 variants.
- The section's SKU form uses predictive search to find variants. Populate SKUs in product admin. Eligible B2B customers see their Shopify catalog prices and rules.
Price breaks
Volume pricing displays the selected variant's Shopify quantity price breaks and quantity rules. The active tier accounts for the product-form quantity plus the quantity already in the cart. Set its Heading inside the Product section; the supplied template already includes it.
Configure pricing and customer eligibility in Shopify B2B catalogs; the theme does not create discounts. If Shopify supplies no price breaks, the block shows quantity rules when present, otherwise nothing on the storefront. Plan and catalog availability are controlled by Shopify.
Fitment finder
Add Vehicle finder to the home page or another template body. Clearcoat's listing home page already includes it. Customers select a vehicle; it is saved in their browser and used by fitment indicators.
- Settings: Heading, Results (Filtered collection or Search), Results collection, Filter metafield (default
lilya.fits). App blocks are supported inside the finder. - Create
lilya_vehicleentries and productlilya.fitsreferences. For Filtered collection mode, enable that metafield as a Search & Discovery filter. Search mode searches product text using the vehicle label; it is not a compatibility filter. - A vehicle entry with its own collection always opens that collection instead of the selected results mode.
- In the Product section, Vehicle fitment has Vehicle finder link, Show compatible vehicles and Open list settings. It shows fit, no fit, unknown or universal status from your data and the saved vehicle.
- Enable Show vehicle fit badge under Atölye product cards for card status. Clearcoat enables it by default. Missing compatibility data is not evidence of a fit.
Documents
The Documents product block reads lilya.documents: either files or lilya_document entries. Set its Heading. Links open in a new tab and display the file extension when available; the block does not show file sizes. Empty entries without a URL are skipped.
For a manually curated list elsewhere, add Document list instead and supply its links and metadata in the editor.
Back in stock
The Back in stock product block shows an email contact form when the selected variant is unavailable. Set an optional Heading and rich Text. The request includes the product, variant, SKU and link.
Requests arrive as Shopify contact-form emails. The theme does not monitor inventory or send automatic restock notifications. For that workflow, use a suitable app's block in the Product section's app area instead.
Hotspots
Add Image hotspots to a template body, then select Image, optional Heading and rich Text, and Show list of points (on by default).
Add up to 30 Hotspot blocks. Each has Product, Label (defaults to product title), rich Text, and horizontal/vertical positions from 0–100%, measured from the image's upper-left corner. A marker opens a popover with the product link, price and optional text. Keep the numbered list enabled to give visitors another way to reach the information.
This module is configured in the editor. It does not automatically read lilya.parts or place points on the product's Exploded tab.
Store setup for quotes, quick order, bundles and locations
The sections below describe how the demo stores are set up, so you can repeat it in your own store.
Quote requests and shipping estimates
Both presets enable b2b_quote_enabled, select the quote page, use audience all and require at least one unit (b2b_quote_minimum=1). Publish that page with suffix quote; its Quote request section is enabled. All supplied PDP templates, including engraving and bundle, contain the base quote-link block. The shared cart page/drawer and quick-order modules supply their own quote launchers. These are contact requests for staff review, not automatic draft orders or reservations. Cart transfers omit personal line properties and selling plans; verify those with the buyer before quoting an engraved item or subscription.
cart_shipping_estimate_enabled=true enables both cart contexts. The drawer also has its View cart link enabled. lb-cart and lb-cart-drawer have no section settings for these features: do not add invented switches to templates/cart.json or a section group. Root and listing cart templates use the same lb-cart section. Configure real shipping profiles/rates and physical product weights in Shopify. The shopper explicitly requests an estimate; checkout determines the final rate.
Quick order and product picker
Publish quick-order with suffix quick-order. Its quantity table uses the quick-order collection, SKU lookup, images and CSV import. The Atölye home page's spare-parts table also has CSV enabled and keeps its spare-parts scope. CSV requires exactly sku,quantity headers; imports add to the cart, while the editable quantity table sets the desired cart quantities. Preview and resolve ambiguous SKUs before adding. Personalized, preorder and required-plan products must be ordered through their PDPs.
The enabled Product picker offers Drive tools / Wrenches / Spare parts for Atölye and Wash / Protect / Interior for Clearcoat. Its optional Product range filter uses filter.p.tag with New|new and Pro|pro. Enable the Product tags filter in Shopify Search & Discovery. The picker navigates to a filtered collection; it does not change the quick-order table inline.
Bundles
Assign suffix bundle only to click-torque-wrench-40-200 in the Atölye demo and vl-09-ceramic-coating in the Clearcoat demo. Each alternate template retains its full PDP and adds a three-product base Bundle section. Product handles are preselected in the section; shoppers select variants and quantities starting at zero.
The section stays hidden until Discount configured (discount_ready) is checked. Create and test an automatic discount for the bundle first, then check it. No discount or linked bundle inventory is created by the theme.
Locations, withdrawal and disclosures
Publish stores with suffix stores for two workshop locations in Atölye or two detailing studios in Clearcoat. Locations are editable Store location blocks; no metaobject, map API key or geolocation permission is needed. The fictional demo addresses/hours are prefilled; replace them before a real launch.
Publish withdrawal with suffix withdrawal, and a separate withdrawal-policy page with the default page template. The enabled Withdrawal request section has fictional merchant contact details and selects that policy page. It remains hidden until the policy resource resolves. Approve real policy/contact details before a real launch. Requests use Shopify contact email and require staff action; they do not cancel orders, create returns or issue refunds. Link both pages from Support.
Clearcoat default/bundle PDPs include an enabled Product disclosure before the buy buttons. It reads product lilya.safety_information, a merchant-owned rich-text metafield. Seed the Safety information heading and approved content on chemical products; leave it absent on accessories so the block stays hidden there. The base summary uses its existing translated disclosure label; there is no heading setting.
Optional B2B catalog mode and hidden prices
Both presets explicitly keep b2b_enabled, b2b_catalog_mode and b2b_hide_prices false. Quotes work independently and do not restrict normal purchases. To opt into restrictions in Theme settings → B2B:
- Enable
b2b_enabled. Chooseb2b_audience:all,login,b2b(a Shopify B2B customer), ortag. Fortag, enter exact, case-sensitive approved customer tags in comma-separatedb2b_tags; an empty list matches nobody. Login alone does not establish wholesale approval. Audience mismatches hide prices and buying. - Enable
b2b_catalog_modeto suppress buying for everyone, including approved customers, while retaining eligible prices. Enableb2b_hide_pricesto suppress both prices and buying for everyone. These switches only act while the master is enabled. Optionalb2b_stock_enabled/b2b_stock_thresholdandb2b_price_labelcontrol wholesale stock copy and the price label. - Configure quote access separately with
b2b_quote_audience; it sharesb2b_tagsfor tag-based approval. Staff must validate requests and manage company/catalog access themselves. - Preview guest, signed-in and approved accounts across cards, collection table, PDP, quick view, cart/drawer, sticky actions and any apps before launch. Custom theme/app surfaces must use the shared
lb-mod-b2b-accessresolver andlb-price/lb-product-stockoutput. These switches are storefront rendering rules, not protection for public APIs or direct checkout; enforce confidential prices and purchasing eligibility through Shopify/server-side controls.