Auvren theme documentation
Create your storefront with confidence. Explore five presets, follow practical setup guides and find the right controls for every detail.
Browse all chapters below.
No matching chapters. Try another feature name or clear the search.
Merchant handbook
Set up your storefront, explore five distinctive presets and make Auvren your own. Start with the essentials below, then use the feature guides and settings reference as you customize.
In Shopify Admin, go to Online Store → Themes and upload your theme ZIP as an unpublished theme. Keep a duplicate of your current theme as a backup. Preview the new theme with your products and menus before publishing. Products, collections and orders belong to your store and are separate from theme styling.
Choose a preset; configure fonts, colors and logo; assign your main and footer menus; connect collections and products; replace sample copy and media; configure shipping, payments, policies and contact details in Shopify. Test the store before inviting customers.
Open Online Store → Themes → Customize (or Edit theme). Theme settings control shared styling and optional features. Choose a template to edit its sections, then select a section or block to see its controls. Use the reference below to look up individual settings.
Use demo layouts as a starting point. Add your own products, photography, brand story and contact details. Review product descriptions, shipping information and policies before publishing so they accurately describe your business.
Your preset controls the design; your Shopify store name controls text logos, footer copyright and store-name metadata. To change your business name, use Settings → General → Store details in Shopify Admin. Review About pages, journal copy, product vendors and search-engine listings separately. Changing the store name does not require changing product handles or your store domain.
Merchant handbook
All presets share Liquid, JavaScript and styling foundations. Their palettes, compositions and merchandising differ; they are not five separate themes.
Warm mineral neutrals, charcoal and restrained bronze. Build around large interiors, featured collections, furniture, narrative details and lookbook scenes. Prioritize meaningful material and dimension information.
Warm white, rose and taupe with soft editorial typography. Connect best sellers, routine discovery, ingredients and benefit content. Publish only supported product claims and genuine customer testimonials.
Ivory, near-black and stone. Use campaign imagery, category discovery, collection grids and editorial stories. Configure real size/color variants and native option swatches; the theme does not create variant data.
Champagne, warm ivory, charcoal and gold. Use macro product photography, craftsmanship stories and gift merchandising. Document actual materials and gift-service terms. Price-labelled choices are enabled for eligible single-option products, so gift-presentation costs can be compared before selecting. Packaging choices do not establish a different jewelry size or material; enter those facts separately.
Espresso, cream, copper and sand. Pair coffee or artisanal collections with origin stories, brewing articles and gifts. Subscription presentation requires genuine Shopify selling-plan data supplied by a compatible integration. Show format and included-item facts before purchase, and compare eligible pack or equipment choices with their native prices. The preset includes an empty Key facts block: connect actual product metafields or enter verified values; unfilled facts stay hidden. Coffee-format choices and equipment capacities are different attributes, not interchangeable variants.
Back up visual customizations before switching. Listing templates provide preset compositions; changing a settings preset alone should not be assumed to replace every template. Verify the installed composition in the editor. Merchant data is separate from theme settings.
Duplicate your theme before comparing styles. Use the same homepage-to-collection-to-product journey with your own images, titles and option names. Check that promotional links lead to populated collections, featured selections relate to the surrounding story, and product information supports the purchase decision. Typography and colors are only part of a style: review section order, product density, image ratios and mobile content order too. Theme style switching changes presentational settings; it does not create catalog data or automatically replace every template composition. Configure each copied theme’s sections and product template explicitly.
Merchant handbook
Use a small, consistent visual system before styling individual sections.
Set page, text, surface, button and button-text colors. Where offered, section color schemes control local presentation. Maintain readable contrast for text, borders, badges and focus states. A custom palette is not automatically accessible.
Choose supported body, heading and navigation fonts. The selected body and heading web fonts receive early loading hints; identical files are requested once and system fonts need no download. Navigation-only fonts load when used. Fallback text remains visible while fonts load, so unusually slow or blocked font delivery can still change text wrapping. No additional setting or app is required. Adjust heading scale, navigation tracking/case, content width, section spacing, grid gaps, media ratios and available corner styles. Review long headings and translated labels at mobile widths. In the Living presentation, large editorial titles use tighter letter spacing; product-card names and cart or recovery headings use more open spacing for readability at smaller sizes. Below 768px, hero and product headings in the Living presentation use more open letter spacing so longer titles can wrap naturally. Your chosen font, heading scale and wording are preserved; desktop display spacing stays unchanged. Preview long product names at phone widths after changing fonts or heading scale. These component defaults do not add a separate editor control.
Set the shared logo in Theme settings → Branding, or override it in Header and Footer. SVG artwork stays vector; PNG/WebP logos use responsive image sizes. Under Branding → Favicon, upload a square icon requested at 32 × 32 pixels. Browsers cache icons, so check in a private window.
Use the motion preference control and respect the shopper’s reduced-motion setting. Test narrow screens, keyboard focus and browser zoom after customization. Do not remove focus indicators to achieve a quieter visual style. Living adds a slight product-photo zoom on desktop hover and short control-color transitions. These respect Enable subtle motion and the device’s reduced-motion preference. Touch browsing keeps static images; controls and content remain immediately usable.
In Theme settings → Branding, choose Storefront design → Living for compact product captions and coordinated spacing. Fonts and colors come from your typography and palette settings. Text logo supplies the accessible name and text fallback; leave it empty to use your store name. Shared logo accepts an SVG or bitmap upload for both header and footer. Set Header logo width and Mobile header logo width independently. An existing Header → Logo selection takes precedence; clear it to use the shared logo. SVGs retain their vector file without raster resizing. Logo colors come from the artwork; upload a contrasting version for dark backgrounds.
Merchant handbook
Add and reorder sections through the editor. Connect real resources before judging empty or placeholder states. The section catalog below includes every implemented section and its exact settings.
Editorial hero supports art-directed images/mobile media, text, links and Shopify video with native controls. Story media offers a full-width narrative or video treatment. Choose its Background video preset (or Media layout → Background video) for silent looping footage behind editorial copy. Select a Shopify-hosted video and optionally a poster and mobile poster; choose Overlay for text over the film or Editorial frame for a clear film above a separate caption. Editorial frame uses the section color scheme, with a two-column caption on desktop and stacked copy on mobile; a small icon control sits on the film. Both background presentations use a 44px keyboard-accessible play/pause icon with a translated accessible name, rather than a large text button. Height caps the desktop film; mobile uses a landscape crop. The dark overlay applies only to Overlay. Set the content position, then add a heading, text and optional link. Leave the poster blank to use the video’s own preview image, which avoids a visual jump between unrelated scenes. Keep footage short and compressed; inspect the result on a mobile connection before publishing. Keep essential information in the text because background footage is decorative and muted. Use Standard player for narrated or instructional content with native controls, caption and transcript. Background mode does not use the standard caption/transcript fields. Autoplay starts only while visible and pauses offscreen or in a hidden tab. The section requests no video preloading until playback is allowed; browsers may still fetch metadata because preload is a browser hint. Reduced motion, data saving, global motion-off and the Theme Editor disable automatic playback; an explicit Play action remains available. A visible Pause control respects a shopper’s pause choice for that section instance. Blocked playback leaves the poster and a retry control. Without JavaScript or a selected video, the poster and text remain. Initial poster images load eagerly when first on the page; later posters are lazy. A mobile poster changes the still image crop, not the video source. For an editorial homepage, a short background film can connect product merchandising to journal or brand content. Keep the main image hero if the film provides supporting atmosphere. Supply short licensed footage without flashing imagery, and check white text contrast against every frame. Background settings affect only that layout; existing Standard player sections remain unchanged. Supply useful image alternatives and appropriate video captions. Do not use a mobile crop that hides the product or CTA. When a campaign shows packaged products, keep its branding, product name and pack size consistent with the destination catalog. For a wide image used in a square layout, check the entire package and label at mobile and desktop widths; use a separate mobile image when the crop cannot retain them. The edge-to-edge color-panel layout also uses that mobile image from 768 to 1023 pixels, where its image column remains narrow. Other hero layouts switch to their desktop image at 768 pixels. Preview both crops across mobile, tablet and desktop.
In Editorial hero → Hero layout, Paired image study places a complementary detail photograph below the introduction on desktop and beside the primary photograph on mobile. Choose Detail image and an optional Detail image caption. When both the primary button label and destination are set, the detail photograph links to that same destination with a keyboard focus indicator; otherwise it remains an unlinked image. Paired-image sizing follows the actual columns and content width. The edge-to-edge color-panel image uses the full mobile width and its desktop column width. Hero image candidates never exceed the uploaded source width; upload a sufficiently detailed original for large or high-density displays. For example, a photograph displayed730px wide needs roughly1460 source pixels for a2× screen. Larger requested CDN sizes cannot add detail to a smaller upload; without a detail image it falls back to the ordinary split layout. Image side controls desktop placement; paired-image mobile order keeps the introduction and shopping link first. Immersive image campaign fills a large opening with photography and keeps the heading, description and links over a dark lower overlay. Choose photographs with clear focal areas, check white text contrast and use the image focal-point controls; a separate mobile image can improve the crop. The primary image loads eagerly when this is the first section. Native video media automatically uses the split layout so its controls are not obscured by campaign copy. Edge-to-edge color panel places the introduction on a solid palette surface beside the image. All compositions share the existing links, heading levels, section color schemes and mobile media settings. Existing Split, Panorama and Heading above room image layouts are unchanged. For a product-led campaign, use a worn or contextual photograph and a front/detail view of the same product. Name that product in the caption and link the primary button to its product page; keep a secondary link to the wider collection. Place Featured products immediately after the hero to continue the selection. These image and URL settings are independent: when changing the campaign, update both and verify that the pictured item is available. Do not imply that styling pieces or an entire outfit are included. For a care-set campaign, use photographs of the actual set variants, label each pictured pack-size selection and link to the corresponding product. Explain that alternative sets are sold separately; use a secondary link for individual products. A combined photograph does not create a bundle or change inventory. Keep captions and links synchronized with the catalog when pack contents or availability change. For products sold by weight, assign each option its matching labelled image in Shopify Admin. Keep the product format and net contents consistent across category imagery, product cards, selected variants and cart. Matching photographic crops do not establish physical package dimensions. If an image is reused by several products, preserve its file and shared alternative text when updating just one product. Upload a separate product-specific image and assign it to the relevant option, then check the other products that use the original.
Featured collections can create a grid or mosaic using collection blocks and image/title overrides. Featured products uses selected products or a collection; individual choices take precedence. Product spotlight presents a selected product with editorial and available purchase controls. Collection, product, journal and editorial cards adapt their heading level automatically: with a section heading they are subheadings; without one they become section-level headings. Their visual size stays unchanged. Keep the page’s main heading in its hero or main template. To present two equally important choices, select two products in Featured products, choose Grid and set desktop columns to 2. Use product-note blocks to explain a verified difference such as whole-bean versus ground format; include available pack sizes only when supported by those products. The notes are merchant-entered and do not automatically track variant changes. Keep them synchronized with the catalog. Present equipment separately when it is not part of a bundle, and state what is included when a styling image shows other items. Do not infer roast, origin, flavour, certification or equipment compatibility from photographs or product names.
Split narrative pairs photography with story, caption and detail blocks. Editorial text supports rich text and quotations. Use real attribution and permission for quotations. Rich text tables and code have contained scrolling where necessary.
Editorial columns supports benefits, logo rows and testimonials through its available presets/blocks. Add only merchant-authorized logos, factual benefits and genuine testimonials. The theme does not supply customer review data.
Image lookbook places product-linked hotspots on a scene. Before/after comparison reveals two supplied images; use honest, comparable images and avoid unsupported results claims. Product comparison presents selected products and authored rows; it does not infer unprovided specifications.
Choose a blog for journal cards. Newsletter uses Shopify’s customer form and native feedback. FAQ uses accessible disclosures with authored answers. Avoid unnecessary duplicate newsletter forms; confirm mailing consent and delivery workflow separately. The Serein preset keeps its Point of view and Visual journal sections hidden initially to avoid repeating imagery and editorial messages. Their saved settings remain available: use the visibility control beside the section in the theme editor to show it again. Choose sections that contribute new product information or useful destinations; hiding a section does not delete its saved content.
Collection tabs groups real collection grids behind accessible manual tabs with a no-JavaScript fallback. A dated promotion uses a fixed merchant-supplied deadline and an ended state; it does not create discounts or reset a deadline for each visitor.
In Featured products choose two, three or four products per desktop row and one or two per mobile row. Tablet uses up to three. Explicitly selected products take precedence over a collection; choose a varied edit deliberately if a collection’s default order introduces new or sold-out QA examples. Larger cards request appropriately sized responsive images. Other product grids retain their own layout.
Collection tiles request images for the selected grid or mosaic layout, including the full-width final tile on mobile when the item count is odd. Product spotlights account for the page margins, content-width setting and column gap. Native responsive sources preserve merchant images and focal points. Browsers may reuse a larger cached image shown elsewhere; these hints do not guarantee a fixed download size.
Presets that include an editorial text section provide editable, original introductory prose. Replace it with your own brand story in the Theme Editor. Demo maintenance fills only matching seeded sections with an empty text setting and preserves existing merchant prose. Demo copy does not assert certifications, customer reviews or product performance.
In Editorial hero, choose Heading above room image to place the heading, introduction and links above a wide photograph. Supply a mobile image when a separate crop is needed. In Featured collections, Compact category links creates a small image-and-title navigation row (four columns on desktop, two on mobile). Assign a real collection to make each tile clickable. Compact category thumbnails stay square, including the final item in an odd-length group. An odd final category spans the mobile row to leave room for its label and description; only grid and mosaic layouts give that final image a wide crop. Split narrative’s Edge-to-edge image and text panel connects the image to its text panel; combine it with a color scheme. These options use existing sections and remain reorderable; the design setting alone does not populate them.
Combine the room hero and compact category links with Featured products, Split narrative, Product spotlight, Rich text and quote, and Journal cards. The expanded demo includes eight editable sections. Select a product for the spotlight, connect a published blog for journal cards, and link the editorial introduction to your About page. Keep repeated product stories purposeful and remove sections that do not serve your catalog.
In Featured products, choose Composition → Lead product and companions for a selection of two to four products. The first product receives the larger image; the remaining products form a compact list on desktop and below it on mobile. One product or more than four falls back to your regular grid and column settings. Add Selection note blocks, select a product already included in this section, and write a short role and accurate selection note. Notes follow their matching product rather than its position, work in both compositions, and the first matching note is used. Unmatched notes are not shown. Reorder selected products to change the lead. Responsive photo sizes follow the editorial grid, page gutters and the Content width setting, including the wider companion images on tablets. This changes which image file the browser requests, not the composition or crop. Prices, links, availability badges and quick-add behavior continue to use real product data. No extra scripts or subscription/bundle mechanics are added. Preview long notes, sold-out products, missing images and translations before publishing. In a two-column mobile grid, an odd final product with a selection note spans the last row, with its image beside the note. Unannotated grids keep their existing layout.
Add Editorial columns and choose Quote and logo selector. Add Testimonial blocks with an authorized quotation, source name, optional logo and source link. Selection is manual, with arrow keys, Home/End and no automatic rotation. Without JavaScript all quotations remain visible. Selecting a block in the editor shows its quotation. The demo statements express each brand’s point of view; they are not customer or publication endorsements.
In Editorial newsletter choose an optional background image, mobile crop and darkening strength. Without imagery the existing palette layout remains. The native customer form retains required email validation and Shopify success/error feedback. Verify actual subscription delivery in your store. With a background image, the heading and description are centered above a centered signup form. Email and Subscribe share a row on desktop and stack on narrow screens. The no-image layout is unchanged.
Add Editorial image gallery and up to ten image blocks. Upload your licensed imagery or select a product as the image/link fallback. Add optional captions, image ratio and a profile/journal/collection link. The two-column mobile grid expands to five columns on desktop. This is a manually curated gallery and does not fetch social-platform content.
In Editorial columns enable Compact service row and add Benefit blocks with optional original line icons. Use factual shipping, returns, payment and support copy and link to your own pages. Do not advertise unconfigured services. Icons sit beside the text in compact mobile rows; the layout expands to two columns on tablets and four on desktop. Text wraps without truncation, links retain touch-friendly targets, and blocks without icons use the full text width. Use descriptive link labels such as Delivery information or Contact us. Compact styling only affects this section when enabled; it does not change other editorial columns.
Theme settings → Layout and motion → Enable subtle motion controls native smooth anchor scrolling and one-time entrance reveals for editorial headings, featured product cards, collection tiles, stories and journal cards. Cards enter with a short stagger and collection photos gently enlarge on pointer hover. First-screen content is never delayed by an entrance animation. Sections already visible when motion initializes stay static; content farther down can reveal once as you reach it. Normal wheel/touch scrolling is preserved. Responsive images below the first screen use native lazy loading; priority hero images load eagerly. There is no scrolling library or image-loading dependency. Reduced motion, disabled motion and editor previews remain static. Content stays available without JavaScript; focusing an animating section cancels its movement.
Merchant handbook
Product data comes from Shopify. Product information uses reorderable blocks; available block types and controls appear in the generated section reference.
Reorder title/vendor, price, SKU/availability, purchase controls, description, text, accordions and supported app blocks. Add ratings through an appropriate app block; the theme does not fabricate reviews. Use supported dynamic sources where Shopify offers the picker.
In the Product section, choose Product layout → Object catalog for a large title above the gallery, framed media with an image counter and zoom entry, and compact quantity/purchase controls. The Title block stays above the gallery in this layout; all other blocks remain reorderable in the information column. Classic retains the original layout. Image framing and thumbnail settings still apply; Editorial crop matches the catalog composition; use Natural to show an uncropped image. Add an Introduction block above Price: connect a short product metafield or supply copy; an empty Introduction shows the opening description paragraph as plain text, limited to 35 words. Keep a Description block for the complete content, optionally as collapsible details with a heading. Empty descriptions stay hidden. Price, options, stock and purchase behavior always use Shopify data. The Policies block can also be collapsed when it has a heading; add your actual delivery/returns information or policy links. No specifications or delivery promises are generated.
In Product → Lead with product title, enable this option for the Classic layout to identify the product before its images on mobile and tablet (below 990 px). On desktop the same Title block leads the information column beside the gallery. Its vendor setting and editor selection are retained; other blocks keep their order. This pins Title independently of its position in the block list. Disable the option to restore the original order. Removing Title removes the leading heading; legacy templates with no blocks retain a fallback title. Object catalog already leads with its title, so this option does not change that layout. The layout works without JavaScript and renders a single product heading. Gallery, options, prices and native purchase forms are unchanged.
Configure balanced/wide gallery width, image framing and thumbnail position. Thumbnails switch media; images open a zoom dialog with Escape and focus return. Native videos and supported 3D media use their platform controls. Before scripts load, the initial product image is already selected. With JavaScript disabled, native thumbnail links switch between all media; older browsers without the required CSS support retain a stacked gallery. Verify video/3D on your actual devices. Short thumbnail rows are centered below the image. Larger galleries remain horizontally scrollable with the first and last item reachable; the desktop side-thumbnail layout retains its vertical alignment. In Shopify Admin → Products, put a clear photograph of the item being purchased first and assign each pack-size or color variant its matching image. A variant image determines the initial product view and cart image; the first gallery image is the default collection-card cover. Keep volumes, colors and included quantities consistent across photographs and product copy. For a packaging family, use comparable framing and legible product and weight labels. A matching package design does not establish roast, origin, ingredient or performance differences; describe only supported product facts. For clothing, pair an unobstructed garment view with a worn view and verified garment measurements; a photograph alone does not establish fit. Describe styling objects separately when they are not included. Every image in a product gallery should match that product’s color and included items; a correct first image does not compensate for a conflicting secondary image. When sizes share the same color, assign the matching color photograph to each size variant. Use useful image alternative text and preview every option, thumbnail and mobile crop before publishing. Image framing and the desktop side-thumbnail column are reserved before gallery scripts load, preventing the main image from resizing as controls initialize. Native thumbnail anchors keep every media item reachable if gallery scripts are unavailable.
Option links use Shopify option-value URLs and reload the product’s authoritative price, media, availability and purchase ID. Other selected options are preserved. Plan choice and unsaved quantity/recipient fields can reset on navigation. Enable native swatches only after configuring real option color/image data in Shopify; missing samples remain readable text.
In the Product section, enter an exact option name in Option displayed as image choices (for example Color). Assign an image to every corresponding variant in Shopify Admin → Products. Matching is case-insensitive. Each choice shows the image of that value combined with the other selected options, plus a visible name. If no variant image exists, its native image swatch is used; otherwise the choice stays text. Selecting a choice reloads Shopify’s authoritative variant, price, availability and featured media while preserving other option values. Browsing gallery thumbnails only changes the viewed media, not the variant purchased. Leave the setting blank for regular options. These links also work without JavaScript; unsaved quantity and selling-plan choices can reset on navigation.
Selected variant pricing, compare-at and unit pricing use Shopify data. Sold-out purchase buttons are disabled. Quantity inputs and enhancement buttons respect minimum, maximum and increment rules. Quantity guidance and native volume tiers display eligible Shopify data; they do not create a custom discount.
The native form submits the selected variant ID and quantity. Enhanced cart handling reports failures without replaying uncertain requests. The optional mobile purchase bar submits the original form and its validation after the primary button scrolls away. Do not remove the main purchase block.
Selling-plan choices come from variant allocations. Select and apply a plan to update its terms; a required plan prevents one-time purchase. A compatible subscription provider and valid plans are prerequisites. Accelerated checkout uses Shopify’s payment controls and is omitted where recipient/personalization validation requires Add to cart. Place a test order for each purchase option you offer before launching. The unbranded Buy it now button uses the page background, foreground text and an outlined border to distinguish it from the solid Add to cart action. Hover uses the surface color; keyboard focus remains visible. These colors follow your theme palette. Branded wallet buttons keep their payment-provider appearance.
Eligible gift-card products can show recipient fields, message and scheduled delivery. Text personalization uses labeled public line-item properties with required/length rules. Use unique property labels. Verify fulfillment and actual gift delivery; the theme cannot guarantee them.
Inventory notices reflect actual tracked availability and optional incoming data, not artificial scarcity. Pickup requires configured Shopify locations and selected-variant availability. Size/material guides accept reusable pages or inline content, with dialog and no-JavaScript disclosure behavior. For jewelry and other size-sensitive products, place Key facts after Price and before Purchase to show verified dimensions before the option controls. Use separate labels for the item’s size, what is included, and its packaging/presentation. Connect values to product metafields through dynamic sources; product-level facts do not change when a variant is selected. Do not use packaging choices as a substitute for actual size options. Empty facts are hidden on the storefront and show setup guidance in the editor. Orivelle includes an unfilled Key facts block in this position so merchants can connect their own data without sample measurements appearing on real products. In the catalog layout, adjacent Price and Key facts blocks share one divider; moving the facts elsewhere restores their own top divider. Keep essential sizing and included-item facts above Purchase. A longer sizing or presentation guide can sit below Purchase so it remains available without interrupting the choice controls. Reorder these blocks in the product template; their content and no-JavaScript fallback remain unchanged.
Product specifications use label/value rows and compatible dynamic sources; empty rows stay hidden. Related/complementary recommendations use Shopify’s service and optional fallbacks. Configure complementary choices in Search & Discovery. Test missing media, empty recommendations and incomplete metafields. Product recommendations supports two to four desktop columns independently of its product limit.
Create product options and variants in Shopify Admin → Products. The theme reads those values automatically; no theme-code changes are needed. Selecting a value loads the matching variant, price and availability, and Add to cart submits that variant. Catalog changes affect every theme on the same store. Demo size choices and prices are examples; replace them with your actual specifications, imagery and stock before selling. A sold-out variant remains unavailable.
In Product, add the Key product facts block near the purchase controls. Enter up to three label/value pairs or connect single-line product metafields. Rows without both a label and value are omitted; an empty block shows an editor hint only. The optional note explains provenance or limitations. Static values apply to every product sharing that template, so use dynamic sources for product-specific facts. For a shorter mobile purchase path, keep the measurement guide near the choices and place the longer facts block immediately after Purchase controls. Blocks remain reorderable; use your actual product information to choose the order.
In Product recommendations, choose Merchant selection and select products or connect a product-list metafield. The current product is excluded. The selection is server-rendered and automatic recommendations cannot replace it. Empty selections are hidden outside the editor. Shopify recommendations remains the default source with related/complementary intent and fallback products. Use a heading that accurately describes the chosen relationship.
In the Product section, add a Linked products block and choose two to eight separately listed products, including the current product. Give the group a clear heading, such as a style name. The group appears only on products selected in that list, so unrelated products using the same template do not show it. Each photograph and product title links to a separate product page; the current page is outlined. Native size and other variant controls remain separate, and selections are not carried between product pages. Products without images keep their visible names. Links work without JavaScript. Each linked-product image uses that product’s first gallery image. For comparable colors or finishes, use the same viewpoint and framing for those covers in Shopify Admin → Products → Media, keeping worn or detail views later in each gallery. Assign matching images to size variants separately so their initial product and cart views agree with the cover. For multiple families, use separate product templates or connect a product-list metafield through a supported dynamic source. This is not a bundle, subscription or variant-creation tool.
In the Product section, enable Show prices in option choices to help shoppers compare pack sizes or other simple choices before selecting. Prices use Shopify variant data and your currency display setting. The feature applies only to products with one option and differing prices. Products with selling plans, choices with volume price breaks, and links to another product retain their standard labels. Missing variant data never produces a guessed price. The selected-product price, native option links and add-to-cart continue to use Shopify’s resolved variant. Selecting a different choice navigates normally, including without JavaScript. This does not change catalog prices, variant order or the initial variant.
Merchant handbook
Use native Shopify catalog and filtering capabilities. Resource availability depends on store configuration.
In Default collection → Collection → Collection introduction, choose Standard, Editorial introduction or Color panel. Editorial places the product count above the title with the description beside it on desktop; Color panel adds a surface-color background. Both stack readable text on mobile and work without imagery or a description. Show collection image uses the collection image, with an optional section image override; use a separate template or dynamic source when an override should apply to only some collections. With an image, the introduction and photograph sit side by side from tablet widths and stack on mobile. Choose images that tolerate the crop and set their focal points. Product counts reflect the current filtered results. These layouts do not change product ordering, prices, filters or pagination. Keep Standard for the existing compact presentation. Configure the optional flat collection-navigation menu separately. Directory pages list collections with pagination, and breadcrumbs retain native destinations.
Configure supported storefront filters in Shopify/Search & Discovery. The theme renders the supplied filters, counts, price ranges and active-filter links. Visual color/image filters need native data; text fallback remains available. Test filter URLs, sorting, clear-all and browser Back/Forward on a real catalog.
The search template preserves the query and presents supported product and non-product results, filtering/sorting where Shopify supplies it, pagination and recovery for empty queries/results. Search indexes and relevance are not created by theme code.
Shared cards display responsive media, product names, native money, optional vendor and sale/sold-out badges. Customize supported image fit/ratio, alignment, hover image and spacing settings. Shared responsive images include smaller 120px and 240px candidates for compact cards; browsers choose the appropriate source for the layout and pixel density. Hover images remain lazy-loaded, but browsers may fetch them before interaction. Sold-out badges remain visible even when sale badges are disabled.
Enable optional quick add in Product cards settings. Eligible simple products can submit one unit directly; products needing choices link to their product page. Keep required app fields and personalization on product pages, and test your actual product configurations.
Product titles in collection and search results use second-level headings beneath the page title. Cards inside editorial sections use third-level headings beneath section headings. Both use the same visual card styling. Keep meaningful section headings when customizing templates.
Collections, collection directories, search, journals and article comments share centered page controls with a marked current page and keyboard focus. Previous/next controls keep accessible labels on narrow screens, where only their arrows are shown. Links preserve Shopify’s filters, sort order and search query; comment links retain the comments anchor. Controls wrap on narrow screens and remain native links without JavaScript. Pagination appears only when more than one page exists; adjust products/articles per page in the relevant section.
Search retains the editable query and offers Explore all products when no query has been submitted or no matches are found. Empty results show one explanation; filter controls remain available when Shopify returns active filters so shoppers can clear them. Without active filters there is no empty filter panel. The Living design uses a compact collection title/count row and a split search heading/form on desktop, stacked on mobile. These layouts use the existing collection title, description, images and navigation settings; they do not change product order, relevance or merchant catalog data.
Under Product cards, enable Show product comparison detail. Create a product metafield with namespace/key custom.card_details and type Single line text. Enter a short verified comparison fact. It appears between the title and price; missing values produce no empty line and long text wraps. When prices vary by size, list the available sizes (for example, 50 ml / 150 ml) rather than placing a full-size volume beside a smaller variant’s From price. Label dimensions explicitly, such as Width 76–94 cm. Keep this merchant-entered text synchronized with your catalog options; it is not generated from variants. In a collection template, select Collection → Show expandable product facts to add a native Details at a glance disclosure beneath each card. Create Single line text product metafields custom.auvren_fact_label_1 through custom.auvren_fact_label_3 and the matching custom.auvren_fact_value_1 through custom.auvren_fact_value_3. Only complete label/value pairs appear; a product with none has no disclosure. Connect the same fields to the product Key facts block so collection and product information agree. These are product-level facts and do not update with a selected variant: list size ranges explicitly and verify the chosen size on the product page. An existing custom.auvren_demo_note field appears inside the disclosure when populated; demo stores retain their illustrative-specifications notice. Use verified measurements for real merchandise. Multiple cards may stay open for comparison; keyboard and no-JavaScript navigation work. This option affects collection cards only and is off by default.
Choose collection order in Shopify Admin → Products → Collections. The theme preserves Shopify’s native sort and filter URLs. To control /collections/all, create a collection with the handle all and select its ordering, following Shopify’s catalog-page instructions. A manual collection needs new products added explicitly; an automated collection needs suitable inclusion rules. Keep sold-out products visible when customers need to browse or compare them.
In Featured collections, open a Collection tile block and enter its optional Short description. Use one or two concise sentences to explain the category or the choice it offers, such as whole bean versus ground coffee. Text appears below the category link in grid, mosaic and compact layouts. Blank descriptions add no paragraph. This is plain text; use the collection picker for the destination. The setting changes only this section, not the collection description in Shopify Admin. Translate merchant text separately for each storefront language. Use accurate product information and keep captions consistent with the category imagery. For a fuller comparison, pair the categories with Split narrative: choose a responsive image ratio, a descriptive image and a link to the relevant collection or product. Its connected panel keeps the image within its column as copy length changes. Illustrative pack comparisons should make clear whether items are sold separately.
Merchant handbook
Configure the shopping bag, optional cart drawer and gift services, then connect your Shopify checkout settings.
Use −/+ or type a quantity, then Update cart to refresh totals. Remove deletes a line. Order note opens a disclosure; saved notes remain visible. Lines show supported options, public properties, unit pricing and discounts. Empty carts offer a return to shopping.
Enable the optional AJAX cart drawer in theme settings. It supports quantity updates, removal, feedback, empty state, focus handling, Escape and scroll lock. Network errors retain recovery paths. Test it with real discounts and app properties before launch. While a response is pending or cannot be confirmed, the drawer hides its previous contents so an old empty state or total cannot be mistaken for the current cart. Use View cart to check the authoritative cart. Closing and reopening the drawer fetches the cart again; a failed add or update is never automatically repeated.
Create and publish a real service/product, then enable Gift wrapping and select it. Eligible simple products add directly; products needing choices link to their product page. Explain per-order/per-item service terms. The theme does not automatically add charges or enforce fulfillment policy. Save cart edits before adding a separate wrap product.
Without JavaScript, native product forms, quantity inputs, cart updates, Remove and checkout navigation remain available. Shopify-hosted checkout requires a supported browser. Test your complete purchase flow after changing cart settings or installing an app.
Configure payments, tax, shipping, discounts and order notifications in Shopify and your chosen integrations. Hosted checkout and customer-account screens have their own branding controls. Before launching, place a test order and verify the confirmation, payment status and order details in Shopify Admin.
Merchant handbook
Theme presentation and Shopify form handling are separate from your policies, legal obligations and fulfillment operations.
Open Footer in the Theme Editor to configure the brand description/short SEO copy, menu blocks, newsletter heading and optional description. The footer presents a newsletter column, editable menu columns and your brand story side by side on wide screens. On mobile the newsletter and brand story span the width while menu groups remain visible in two columns. Email input and subscribe button are stacked. Localization, privacy controls, policies and payment methods sit below the directory. Footer logo override is optional: leave it empty to use Theme settings → Branding → Shared logo. Set Footer logo width independently; mobile scales it down to fit. Without either upload, Text logo or the store name appears. Keep descriptions factual and useful. In Theme settings → Social links, enter complete https:// profile URLs for Facebook, X (Twitter), TikTok, Pinterest and Instagram. The footer shows a compact icon row beneath the brand description, with accessible names and keyboard focus indicators. Empty or non-HTTP(S) destinations are omitted; an entirely empty row is hidden. Existing Instagram and Pinterest settings are preserved. Links open in the same tab, and no social embeds, tracking scripts or platform requests are loaded by the icons. Localization appears only when multiple languages or countries are available. Cookie preferences, actual store policies and enabled payment icons retain their native behavior. Newsletter uses Shopify’s customer form with required email validation and server success/error feedback; verify actual subscription delivery on your store. Disabling the newsletter or removing menu blocks leaves no empty column. No developer-credit or affiliate link is added.
In the Theme Editor → Footer group → Add section, choose Newsletter invitation. This optional non-modal corner panel uses Shopify’s customer form with editable content, palette and delay. Automatic display is once per tab session and off on mobile by default. Closing or pressing Escape dismisses it with no floating reopen button. Shoppers can still subscribe through the footer form. Automatic display waits while consent, navigation, cart, search suggestions or input editing need attention. It does not steal focus or lock scrolling; closing from inside restores the prior focus where available. If session storage is unavailable, automatic display stays off. With JavaScript disabled the invitation stays hidden and the footer form remains available. Selecting the section in the editor opens a preview; deselecting closes it. Server form feedback can reopen the panel after submission. No subscription is created until the shopper submits the form. The invitation also waits while Shopify’s native cookie banner or preferences dialog is visible.
Use the standard page template for About, FAQ or service content; use the contact template for Shopify’s native contact form. Native validation and success/error feedback are implemented, but actual mail delivery must be verified in your store. Enable Editorial layout in the Page section for a wider illustrated About page, a larger opening paragraph and a separate, smaller scale for section subheadings. The underlying rich text remains editable in Shopify Pages.
Select and populate a blog, add licensed featured images and useful original articles. Templates support pagination, metadata, topic/neighbor navigation and native moderated comments where enabled. Merchant moderation and spam handling remain store responsibilities.
Theme utility templates provide protected-store forms, recovery search and gift-card display/print features. Shopify’s mandatory client-transfer access screen appears before the theme and cannot be restyled by this theme. Preview the theme password template separately after authenticating.
Account links use Shopify’s customer-account experience. English and French interface and editor translations are supplied; translate your product and editorial content separately. Markets and currency formats follow Shopify settings. Review menus, forms and alignment in every language you offer.
Merchant handbook
The theme uses Shopify’s default cookie banner and preferences. It does not provide a separate consent panel or save consent itself.
In Shopify admin → Settings → Customer privacy → Cookie banner, configure regions, content, appearance and position. The banner is supplied by Shopify, independently of theme settings. Its visibility depends on your store configuration and the visitor’s region and saved choice.
The footer button opens Shopify’s native preferences when privacyBanner.showPreferences is available. It stays hidden when that interface is unavailable and becomes available when Shopify finishes loading its interface. Other theme features can load independently. Delayed stylesheets that affect the native privacy interface are still recognized; your published privacy policy remains accessible through its normal link. The theme responds when native consent panels are added, removed or hidden by their containers, including after a section reload. Product-grid updates do not reopen consent preferences or dismissed newsletter invitations.
Newsletter invitations wait while Shopify’s cookie banner or preferences are visible. The back-to-top control stays out of the way until those interfaces close.
The former custom banner and its editor settings have been removed. Older saved privacy_banner values are ignored. The theme does not reset consent, modify tracking permissions or load a replacement banner when Shopify’s service is unavailable.
Test with a fresh browser session in a configured region. Confirm Shopify’s banner appears, a choice persists and Cookie preferences reopens the native interface. Shopify manages languages and consent persistence; configure apps and custom tracking separately.
Merchant handbook
Use native configuration before custom code. Optional capabilities should not become dependencies for basic shopping.
Add compatible app blocks in supported Product, Product spotlight or Apps placements. Install and configure the app first. The theme does not bundle rating, subscription or fulfillment services. Test real editor add/remove/reorder behavior and app scripts.
Use Custom Liquid sections/blocks for trusted merchant code. Invalid markup or scripts can affect layout, security and performance. Back up the theme before editing and never paste credentials into storefront code.
Enable the merchant setting and add the section. Recording starts only after shopper opt-in. Product handles are stored in tab sessionStorage; Stop and clear removes that tab’s opt-in/history. This is not a consent-management integration. Review privacy requirements and browser tab restoration behavior.
Duplicate your customized theme and review changes in an unpublished copy. Preserve settings, menus, content and app configuration. Do not overwrite settings_data.json to install a small code fix. Test native purchase, filters, dialogs, app blocks and responsive layout after changes.
Editorial sections load their shared styles automatically, including when JavaScript is unavailable. No app or editor switch is required. Reordering sections does not change the newsletter heading scale. For code customizations, edit assets/homepage.css and run npm run styles:build followed by npm run docs:build before uploading; upload the generated snippets/editorial-styles.liquid with the CSS source. The generated snippet should not be edited directly.
Merchant handbook
Use this checklist when launching your storefront or publishing a major theme update.
Replace sample images and text. Confirm your logo, favicon, colors and typography. Read every core page on mobile and desktop, and give important images useful alternative text.
Publish the right products and collections to the Online Store channel. Check option names, prices, stock, product photography, filtering, sorting and search. Confirm every menu and promotional link reaches the intended destination.
Test an available product, a product with options and a sold-out product. Add items to the cart, change quantities, remove a line and check totals. Place a test order using an appropriate Shopify test gateway, then confirm the result in Orders.
Review contact details, shipping destinations and rates, return terms and policies. Confirm your contact and newsletter workflows and explain any gift services or subscriptions you offer.
Browse with a keyboard and check visible focus, menu operation, dialogs and form labels. Review text at increased zoom and test on the devices and browsers your customers use. Keep text readable over images and maintain contrast when changing colors.
Save a backup, preview the final theme and publish from Online Store → Themes when your store is ready. Recheck the public storefront, navigation and purchase flow after publishing. Keep a record of the version and any custom changes.
Merchant handbook
Start with the checks below. When contacting support, describe what you expected and what happened instead.
Confirm the store and theme ID. Exit a stale preview session or use a private window. Browser favicon caches can outlive a normal refresh. Shopify’s default client-transfer password screen is not proof that the live theme is incorrect.
Select the required collection, product, blog or media. Check product publication/channel availability and Shopify image processing. Missing optional content can intentionally hide a section. Inspect that section’s controls in the reference below.
Check the selected option/variant, market/currency and selling-plan allocation. Follow native option links and confirm the resulting product URL. Prices and stock belong to Shopify, not theme text settings.
Confirm menu destinations, nested links and the exact parent URL used for menu promotions. Native filters require configured Shopify definitions and eligible catalog data. Check a direct collection URL as well as browser Back and Forward navigation.
Include the theme version, page address, browser and device, steps to reproduce the issue and a screenshot where helpful. Describe recent setting, app or code changes. Remove checkout tokens and personal information from shared URLs and screenshots. Never share passwords, access tokens or payment details.
Use the Contact support link at the foot of this handbook, or email support@appnory.com. Include your store URL, affected page and reproduction steps. Standard support covers theme setup, settings and theme defects; custom development and third-party app changes are separate. We aim to respond within two business days. The support form uses FormSubmit to deliver your request and acknowledgement; never include passwords, access tokens or customer data.
Merchant handbook
Keep a backup of your storefront and review important shopping journeys whenever your theme, apps or catalog change.
Duplicate the current theme and record important settings and custom code. Review the update notes supplied with your theme. Use an unpublished copy to check compatibility with your catalog and installed apps.
Confirm your header, menus, homepage sections, product options, cart, forms and language settings. Test at mobile and desktop sizes. Keep the current published theme available while reviewing the replacement.
Record custom edits and app-specific instructions before updating. Reapply only the changes you still need, and test each one. Avoid copying an older settings file over a newer theme without reviewing its compatibility.
Use documentation supplied with your theme version. Search this handbook for feature names or use the section and settings references below. Keep your own notes about store-specific configuration and customizations.
Merchant handbook
Give brand stories and journals a deliberate reading hierarchy. Editorial About pages use a comfortable reading size and subordinate section headings.
In Page, enable Editorial reading layout for a larger introduction, wider title and responsive editorial images. Use a separate page template when only About needs this treatment. The option is off by default.
In Blog, enable Feature the first article. The first illustrated article spans the desktop grid with text alongside it. Mobile uses the normal reading order; articles without images retain the ordinary card layout. The option is off by default.
Settings reference
Look up the controls available under Theme settings. Resource pickers connect existing Shopify content; compatible dynamic sources appear where Shopify supports them.
| Control | Type | Choices and guidance |
|---|---|---|
Faviconfavicon | image_picker | Upload a square icon. Displayed at 32 × 32 pixels. No fixed default. |
Text logobrand_text | text | Optional. Used when no header image logo is selected, and in the footer. Leave blank to use the store name. No fixed default. |
Shared logobrand_logo | image_picker | Upload an SVG for a sharp vector logo, or a PNG/WebP image. Used in the header and footer unless a section has its own logo. Text logo is the accessible name and fallback. No fixed default. |
Header logo widthlogo_width | range | Range: 80–280; step 10; px.Default: 150 |
Mobile header logo widthlogo_width_mobile | range | Range: 60–180; step 10; px.Default: 120 |
Storefront designdesign_layout | select | Classic (classic); Living (living)Default: classic |
| Control | Type | Choices and guidance |
|---|---|---|
Body fonttype_primary_font | font_picker | Default: work_sans_n4 |
Heading fonttype_heading_font | font_picker | Default: libre_baskerville_n4 |
| Control | Type | Choices and guidance |
|---|---|---|
Backgroundbackground_color | color | Default: #FAF9F6 |
Textforeground_color | color | Default: #292724 |
Media and panelssurface_color | color | Default: #F0EDE7 |
Buttonsaccent_color | color | Default: #705342 |
Button textbutton_text_color | color | Choose a readable contrast against the Buttons color. Outline buttons use the surrounding text color. Default: #FFFFFF |
| Control | Type | Choices and guidance | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
color_schemescolor_schemes | color_scheme_group | No fixed default. Fields within each scheme:
|
| Control | Type | Choices and guidance |
|---|---|---|
Content widthcontent_width | range | Range: 1000–1600; step 50; px.Default: 1400 |
Section spacingsection_spacing | range | Range: 32–120; step 8; px.Default: 72 |
Control corner radiusinput_corner_radius | range | Range: 0–12; step 1; px.Default: 0 |
Enable subtle motionenable_motion | checkbox | Default: true |
| Control | Type | Choices and guidance |
|---|---|---|
Image shapecard_ratio | select | Square (1 / 1); Portrait (4 / 5); Landscape (3 / 2)Default: 4 / 5 |
Image fitcard_image_fit | select | Fit shows the whole product image with the media background visible around it. Crop to fill (cover); Fit whole image (contain)Default: cover |
Text alignmentcard_text_alignment | select | Start (start); Center (center)Default: start |
Show sale badgecard_sale_badge | checkbox | Sold-out labels remain visible. Sale prices are always shown. Default: true |
Show vendorcard_vendor | checkbox | Default: true |
Show second image on hovercard_secondary | checkbox | Default: true |
Show currency codecurrency_code | checkbox | Default: true |
Enable quick addcard_quick_add | checkbox | Adds one unit of simple products; products with choices open their product page. Leave disabled if products require personalization or app-provided purchase fields. Default: false |
Show product comparison detailcard_details | checkbox | Uses the single-line product metafield custom.card_details. Products without this field show no extra line. Default: false |
| Control | Type | Choices and guidance |
|---|---|---|
Facebooksocial_facebook | url | No fixed default. |
X (Twitter)social_twitter | url | No fixed default. |
TikToksocial_tiktok | url | No fixed default. |
Instagramsocial_instagram | url | No fixed default. |
Pinterestsocial_pinterest | url | No fixed default. |
| Control | Type | Choices and guidance |
|---|---|---|
Open cart links in a drawerenable_cart_drawer | checkbox | Default: false |
| Control | Type | Choices and guidance |
|---|---|---|
Offer a gift-wrap product in the cartenable_gift_wrap | checkbox | Default: false |
Gift-wrap productgift_wrap_product | product | Choose a real product priced and fulfilled as your gift-wrap service. Products requiring options open their product page. No fixed default. |
Service detailsgift_wrap_text | text | No fixed default. |
| Control | Type | Choices and guidance |
|---|---|---|
Enable opt-in recently viewed productsenable_recently_viewed | checkbox | Add a Recently viewed section so shoppers can opt in or stop and clear tab-session history. No history is recorded before opt-in. Default: false |
| Control | Type | Choices and guidance |
|---|---|---|
Heading scaleheading_scale | range | Range: 80–120; step 5; %.Default: 100 |
Product grid spacinggrid_gap | range | Range: 12–40; step 4; px.Default: 32 |
Navigation fonttype_navigation_font | font_picker | Default: work_sans_n4 |
Navigation letter spacingnavigation_spacing | range | Range: 0–3; step 0.5; px.Default: 0 |
Navigation text stylenavigation_case | select | As written (none); Uppercase (uppercase)Default: none |
Button corner radiusbutton_corner_radius | range | Range: 0–24; step 2; px.Default: 0 |
| Control | Type | Choices and guidance |
|---|---|---|
Show back-to-top buttonenable_back_to_top | checkbox | Default: true |
Section reference
41 section references. Use Add section when a section exposes an editor preset. Header, footer, resource templates and internal response sections have specialized placements; not every entry is a general homepage section.
sections/404.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Show search formshow_search | checkbox | Default: true |
sections/announcement-bar.liquid
Editor presets: Announcement bar
Enabled placements: {"groups":["header"]}
| Control | Type | Choices and guidance |
|---|---|---|
Announcementtext | text | No fixed default. |
Linklink | url | No fixed default. |
Discount codediscount_code | text | Create and activate this code in Shopify Discounts. Displaying a code does not create a discount. No fixed default. |
Show copy-code buttoncopy_code | checkbox | Default: true |
Offer link labellink_label | text | No fixed default. |
Background colorbackground_color | color | No fixed default. |
Text colortext_color | color | No fixed default. |
sections/apps.liquid
Editor presets: Apps
| Control | Type | Choices and guidance |
|---|---|---|
Use section spacingpadding | checkbox | Default: true |
Compatible installed apps can provide their own controls. Theme code does not define those settings.
sections/article.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Show article imageshow_image | checkbox | Default: true |
Show publication dateshow_date | checkbox | Default: true |
Show authorshow_author | checkbox | Default: true |
Show article topicsshow_tags | checkbox | Default: true |
sections/blog.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Feature the first articleeditorial_layout | checkbox | Default: false |
Articles per pagepage_size | range | Range: 3–24; step 3.Default: 9 |
Show publication dateshow_date | checkbox | Default: true |
Show authorshow_author | checkbox | Default: true |
Show article excerptshow_excerpt | checkbox | Default: true |
sections/cart-drawer.liquid
Used within a template, section group or theme response; not available in Add section.
No individual settings are declared here.
sections/cart.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Show order noteshow_note | checkbox | Default: true |
Show accelerated checkout buttonsshow_accelerated | checkbox | Default: true |
sections/collection-tabs.liquid
Editor presets: Collection tabs
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Items to showlimit | range | Range: 2–12; step 1.Default: 4 |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
collection
| Control | Type | Choices and guidance |
|---|---|---|
Collectioncollection | collection | No fixed default. |
Tab label (optional)label | text | No fixed default. |
sections/collection.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Show expandable product factsshow_product_facts | checkbox | Uses custom.auvren_fact_label_1–3 and custom.auvren_fact_value_1–3 product metafields. Only complete pairs appear. Keep them consistent with product Key facts. Default: false |
Show breadcrumbsshow_breadcrumbs | checkbox | Default: true |
Collection introductionheader_layout | select | Editorial and Color panel pair the title and product count with the description. An optional collection image appears beside the introduction. Standard (standard); Editorial introduction (editorial); Color panel (panel)Default: standard |
Show collection imageshow_image | checkbox | Default: true |
Collection image overrideimage | image_picker | Uses the collection image when no override is selected. No fixed default. |
Show collection descriptionshow_description | checkbox | Default: true |
Results per pagepage_size | range | Range: 12–48; step 12.Default: 24 |
Show filter swatchesshow_filter_swatches | checkbox | Uses swatch or image presentations configured in Shopify Search & Discovery. Labels and counts remain visible; missing visuals use text only. Default: false |
Collection navigation menunavigation_menu | link_list | Displays top-level menu links above the filters. Use a flat menu for sibling collections; nested links are not displayed here. No fixed default. |
Show collection thumbnails in navigationnavigation_images | checkbox | Default: false |
sections/collections.liquid
Editor presets: Collections grid
| Control | Type | Choices and guidance |
|---|---|---|
Grid item widthgrid_item_width | select | Small (collections--compact); Large (collections--full)Default: collections--full |
Grid spacinggrid_gap | range | Range: 0–50; step 5; px.Default: 10 |
Show breadcrumbsshow_breadcrumbs | checkbox | Default: true |
Show collection descriptionshow_description | checkbox | Default: true |
Show product countsshow_count | checkbox | Default: false |
Results per pagepage_size | range | Range: 12–48; step 12.Default: 24 |
sections/contact.liquid
Used within a template, section group or theme response; not available in Add section.
Enabled placements: {"templates":["page"]}
| Control | Type | Choices and guidance |
|---|---|---|
Heading overrideheading | text | No fixed default. |
Show page contentshow_page_content | checkbox | Default: true |
Additional introductionintroduction | richtext | No fixed default. |
Show optional phone fieldshow_phone | checkbox | Default: true |
sections/custom-liquid.liquid
Editor presets: Custom Liquid
| Control | Type | Choices and guidance |
|---|---|---|
Liquidcustom_liquid | liquid | No fixed default. |
sections/custom-section.liquid
Editor presets: Custom section
| Control | Type | Choices and guidance |
|---|---|---|
Backgroundbackground_image | image_picker | No fixed default. |
@theme
No individual settings are declared here.
sections/dated-promotion.liquid
Editor presets: Dated promotion
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
End date and timedeadline | text | Use a real deadline with timezone, for example 2027-06-30T18:00:00+01:00. No recurring or automatically resetting deadlines. No fixed default. |
Show remaining days, hours and minutesshow_countdown | checkbox | Default: false |
Text after deadlineended_text | text | No fixed default. |
sections/editorial-columns.liquid
Editor presets: Benefits, Logo row, Testimonials, Quote and logo selector, Service highlights
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Presentationlayout | select | Columns (columns); Quote and logo selector (quotes)Default: columns |
Compact service rowcompact | checkbox | Default: false |
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
benefit
| Control | Type | Choices and guidance |
|---|---|---|
Service iconicon | select | None (none); Parcel (parcel); Return arrow (return); Conversation (conversation); Payment card (payment)Default: none |
Imageimage | image_picker | No fixed default. |
Titletitle | text | No fixed default. |
Texttext | richtext | No fixed default. |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
logo
| Control | Type | Choices and guidance |
|---|---|---|
Imageimage | image_picker | No fixed default. |
Titletitle | text | No fixed default. |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
testimonial
| Control | Type | Choices and guidance |
|---|---|---|
Texttext | richtext | No fixed default. |
Titletitle | text | No fixed default. |
Source logologo | image_picker | Use only logos and quotations you have permission to publish. No fixed default. |
Original source linklink | url | No fixed default. |
sections/editorial-faq.liquid
Editor presets: FAQ
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
question
| Control | Type | Choices and guidance |
|---|---|---|
Questionquestion | text | No fixed default. |
Answeranswer | richtext | No fixed default. |
sections/editorial-gallery.liquid
Editor presets: Editorial image gallery
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | Default: Life around the collection. |
Texttext | richtext | No fixed default. |
Link labellink_label | text | No fixed default. |
Linklink | url | Optional profile, journal or collection destination. Images are curated manually; this is not a live social feed. No fixed default. |
Image ratioratio | select | Square (1 / 1); Portrait (4 / 5)Default: 1 / 1 |
Show captionscaptions | checkbox | Default: true |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Default: false |
Color schemecolor_scheme | color_scheme | Default: mineral |
image
| Control | Type | Choices and guidance |
|---|---|---|
Imageimage | image_picker | No fixed default. |
Product image and link fallbackproduct | product | No fixed default. |
Captioncaption | text | No fixed default. |
Linklink | url | No fixed default. |
sections/editorial-text.liquid
Editor presets: Rich text and quote, Editorial quote
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Display text as a quotequote | checkbox | Default: false |
Quote attributionattribution | text | No fixed default. |
Alignmentalignment | select | Start (start); Center (center)Default: center |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
sections/featured-collections.liquid
Editor presets: Featured collections, Collection mosaic
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Layoutlayout | select | Grid (grid); Editorial mosaic (mosaic); Compact category links (compact)Default: grid |
Empty collection labelplaceholder | text | Default: Collection |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
collection_tile
| Control | Type | Choices and guidance |
|---|---|---|
Collectioncollection | collection | No fixed default. |
Imageimage | image_picker | No fixed default. |
Titletitle | text | No fixed default. |
Short descriptiondescription | textarea | Explain who this category is for or what shoppers can compare. Leave blank to hide. No fixed default. |
sections/featured-products.liquid
Editor presets: Featured products
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Compositionlayout | select | Lead product works with 2–4 selected products. Other counts use the grid. Grid column controls apply to the grid only. Even grid (grid); Lead product and companions (editorial)Default: grid |
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Productsproducts | product_list | No fixed default. |
Collectioncollection | collection | No fixed default. |
Items to showlimit | range | Range: 2–12; step 1.Default: 4 |
Products per row on desktopcolumns_desktop | range | Range: 2–4; step 1.Default: 4 |
Products per row on mobilecolumns_mobile | select | One (1); Two (2)Default: 2 |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
product_note
| Control | Type | Choices and guidance |
|---|---|---|
Productproduct | product | Choose a product already in this section’s selection. The note follows that product when reordered. Only the first matching note is used. No fixed default. |
Short role or categorylabel | text | No fixed default. |
Selection notetext | textarea | Explain why this product belongs in the edit. Use accurate details; avoid unverified product claims. No fixed default. |
sections/header-cart-preview.liquid
Used within a template, section group or theme response; not available in Add section.
No individual settings are declared here.
sections/header.liquid
Used within a template, section group or theme response; not available in Add section.
Enabled placements: {"groups":["header"]}
| Control | Type | Choices and guidance |
|---|---|---|
Show cart preview on desktop hoverenable_cart_preview | checkbox | Default: true |
Show country and currencyshow_country_selector | checkbox | Uses countries enabled in Shopify Markets. A single available country displays a label. On mobile, the selector appears inside navigation. Default: true |
Logologo | image_picker | No fixed default. |
Main menumenu | link_list | Default: main-menu |
Keep header visiblesticky | checkbox | Default: true |
Customer account menucustomer_account_menu | link_list | Default: customer-account-main-menu |
Apply section color schemeapply_color_scheme | checkbox | Default: false |
Color schemecolor_scheme | color_scheme | Default: mineral |
Desktop header layoutdesktop_layout | select | Stacked (stacked); Inline (inline)Default: stacked |
menu_promotion
| Control | Type | Choices and guidance |
|---|---|---|
Parent menu destinationmenu_item | url | Choose the same URL as a top-level main-menu item with nested links. Tiles appear under each matching destination; translated menu titles do not affect matching. No fixed default. |
Image (desktop only)image | image_picker | No fixed default. |
Headingheading | text | No fixed default. |
Short descriptiontext | text | No fixed default. |
Promotion destinationlink | url | No fixed default. |
sections/image-comparison.liquid
Editor presets: Before / after images
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
First imagebefore_image | image_picker | No fixed default. |
First image labelbefore_label | text | No fixed default. |
Second imageafter_image | image_picker | No fixed default. |
Second image labelafter_label | text | No fixed default. |
Desktop image ratioratio | select | Square (1); Landscape (3:2) (1.5); Portrait (4:5) (0.8)Default: 1.5 |
Mobile image ratiomobile_ratio | select | Square (1); Landscape (3:2) (1.5); Portrait (4:5) (0.8)Default: 1 |
Initial first-image revealposition | range | Range: 0–100; step 5; %.Default: 50 |
sections/image-lookbook.liquid
Editor presets: Image lookbook
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Imageimage | image_picker | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
hotspot
| Control | Type | Choices and guidance |
|---|---|---|
Productproduct | product | No fixed default. |
Horizontal positionx | range | Range: 5–95; step 1; %.Default: 50 |
Vertical positiony | range | Range: 5–95; step 1; %.Default: 50 |
sections/journal-cards.liquid
Editor presets: Journal cards
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Blogblog | blog | No fixed default. |
Items to showlimit | range | Range: 2–6; step 1.Default: 3 |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
sections/page.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Show page titleshow_title | checkbox | Default: true |
Use wide content areawide | checkbox | Default: false |
Editorial reading layouteditorial_layout | checkbox | Default: false |
sections/password.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Heading overrideheading | text | No fixed default. |
Additional introductionintroduction | richtext | No fixed default. |
sections/product-comparison.liquid
Editor presets: Product comparison
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Product 1product_1 | product | No fixed default. |
Product 2product_2 | product | No fixed default. |
Product 3product_3 | product | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
row
| Control | Type | Choices and guidance |
|---|---|---|
Labellabel | text | No fixed default. |
Value for product 1value_1 | richtext | No fixed default. |
Value for product 2value_2 | richtext | No fixed default. |
Value for product 3value_3 | richtext | No fixed default. |
sections/product-recommendations.liquid
Editor presets: Product recommendations
Enabled placements: {"templates":["product"]}
| Control | Type | Choices and guidance |
|---|---|---|
Product selectionsource | select | Shopify recommendations (automatic); Merchant selection (selected)Default: automatic |
Selected productsselected_products | product_list | Choose products or connect a product-list metafield for a different selection on each product. Automatic recommendations will not replace this selection. Empty selections are hidden. No fixed default. |
Products per row on desktopcolumns_desktop | range | Range: 2–4; step 1.Default: 4 |
Headingheading | text | Default: Consider these, too. |
Eyebroweyebrow | text | No fixed default. |
Recommendation typeintent | select | Related products (related); Complementary products (complementary)Default: related |
Product countlimit | range | Range: 2–10; step 1.Default: 4 |
Fallback productsfallback_products | product_list | No fixed default. |
Link labellink_label | text | No fixed default. |
Optional linklink | url | No fixed default. |
sections/product-specifications.liquid
Editor presets: Product specifications
Enabled placements: {"templates":["product"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | Leave blank to use the translated Specifications heading. No fixed default. |
Introductiontext | richtext | No fixed default. |
Desktop layoutlayout | select | Heading beside specifications (split); Heading above specifications (stacked)Default: split |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
specification
| Control | Type | Choices and guidance |
|---|---|---|
Labellabel | text | No fixed default. |
Valuevalue | richtext | Enter a value or connect a compatible product metafield using the dynamic source picker. Rows with an empty label or value are hidden from customers. No fixed default. |
sections/product-spotlight.liquid
Editor presets: Product spotlight
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Productproduct | product | No fixed default. |
Empty collection labelplaceholder | text | Default: Product spotlight |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
Show purchase controlsshow_purchase | checkbox | Adds a native product form. Option and purchase-plan changes open the product page. Leave off for products requiring personalization or app-provided fields. Default: false |
Show accelerated checkoutshow_dynamic_checkout | checkbox | Default: false |
Show option swatchesshow_option_swatches | checkbox | Uses color or image swatches configured for product option values in Shopify. Names stay visible; values without swatch data use text buttons. Default: false |
Compatible installed apps can provide their own controls. Theme code does not define those settings.
custom_liquid
| Control | Type | Choices and guidance |
|---|---|---|
Liquid codecontent | liquid | No fixed default. |
sections/product.liquid
Used within a template, section group or theme response; not available in Add section.
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Product layoutlayout | select | Object catalog places the Title block above the gallery. All other blocks retain their order in the information column. Classic (classic); Object catalog (catalog)Default: classic |
Lead with product titlelead_title | checkbox | Classic layout: pins the Title block before images on mobile and at the top of the information column on desktop. Disable to restore its block position. Catalog already has a leading title. Default: false |
Show mobile purchase barsticky_purchase | checkbox | Default: false |
Show prices in option choicesshow_option_prices | checkbox | For one-option products with different prices. Selling plans, volume pricing and options linked to other products keep their standard labels. Default: false |
Show option swatchesshow_option_swatches | checkbox | Uses color or image swatches configured for product option values in Shopify. Names stay visible; values without swatch data use text buttons. Default: false |
Option displayed as image choicesimage_option_name | text | Enter an option name, such as Color. Assign variant images in Shopify. Choices without images keep their text labels. No fixed default. |
Desktop gallery widthgallery_width | select | Balanced (balanced); Wide (wide)Default: balanced |
Image ratiogallery_ratio | select | Square (square); Portrait (4:5) (portrait); Original image ratio (natural); Editorial crop (editorial)Default: square |
Desktop thumbnail placementgallery_thumbnails | select | Below media (below); Beside media (side)Default: below |
Show breadcrumbsshow_breadcrumbs | checkbox | Default: false |
Compatible installed apps can provide their own controls. Theme code does not define those settings.
title · Per-type limit: 1
| Control | Type | Choices and guidance |
|---|---|---|
Show vendorshow_vendor | checkbox | Default: true |
price · Per-type limit: 1
No individual settings are declared here.
introduction · Per-type limit: 1
| Control | Type | Choices and guidance |
|---|---|---|
Contenttext | richtext | Connect a short product metafield or write text. When empty, shows the opening description paragraph as plain text, up to 35 words. Keep the Description block for the full text. No fixed default. |
purchase · Per-type limit: 1
| Control | Type | Choices and guidance |
|---|---|---|
Show accelerated checkoutdynamic_checkout | checkbox | Default: true |
Show gift-card recipient fieldsshow_recipient | checkbox | Default: true |
description · Per-type limit: 1
| Control | Type | Choices and guidance |
|---|---|---|
Show as collapsible detailscollapsible | checkbox | Default: false |
Headingheading | text | Default: About this object |
text
| Control | Type | Choices and guidance |
|---|---|---|
Texttext | richtext | No fixed default. |
accordion
| Control | Type | Choices and guidance |
|---|---|---|
Headingheading | text | Default: Product details |
Contentcontent | richtext | No fixed default. |
pickup · Per-type limit: 1
No individual settings are declared here.
guide
| Control | Type | Choices and guidance |
|---|---|---|
Headingheading | text | No fixed default. |
Guide pagepage | page | Page content takes precedence over the text below. Use a page for measurement tables. No fixed default. |
Contentcontent | richtext | No fixed default. |
custom_liquid
| Control | Type | Choices and guidance |
|---|---|---|
Liquid codecontent | liquid | No fixed default. |
inventory · Per-type limit: 1
| Control | Type | Choices and guidance |
|---|---|---|
Show tracked inventory countshow_count | checkbox | Default: false |
Show expected incoming dateshow_incoming | checkbox | Default: false |
personalization
| Control | Type | Choices and guidance |
|---|---|---|
Field labellabel | text | Use a unique label per field. This becomes the cart line-item property name. Requires a purchase block. No fixed default. |
Help texthelp | text | No fixed default. |
Requiredrequired | checkbox | Default: false |
Maximum charactersmax_length | range | Range: 10–200; step 10.Default: 100 |
policies · Per-type limit: 1
| Control | Type | Choices and guidance |
|---|---|---|
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Show contextual tax informationshow_tax_information | checkbox | Default: true |
Show as collapsible detailscollapsible | checkbox | Default: false |
key_facts
| Control | Type | Choices and guidance |
|---|---|---|
Headingheading | text | No fixed default. |
Supporting notenote | text | Optional information about the source or meaning of these details. No fixed default. |
Fact 1 labellabel_1 | text | No fixed default. |
Fact 1 valuevalue_1 | text | No fixed default. |
Fact 2 labellabel_2 | text | No fixed default. |
Fact 2 valuevalue_2 | text | No fixed default. |
Fact 3 labellabel_3 | text | No fixed default. |
Fact 3 valuevalue_3 | text | No fixed default. |
linked_products
| Control | Type | Choices and guidance |
|---|---|---|
Headingheading | text | Default: t:pdp.linked_products |
Products in this groupproducts | product_list | Include the current product. Shown only on selected products when at least two are available to the storefront. Links open separate product pages; they do not select variants. No fixed default. |
sections/recently-viewed-card.liquid
Used within a template, section group or theme response; not available in Add section.
No individual settings are declared here.
sections/recently-viewed.liquid
Editor presets: Recently viewed
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
Items to showlimit | range | Range: 2–6; step 1.Default: 4 |
sections/search.liquid
Used within a template, section group or theme response; not available in Add section.
| Control | Type | Choices and guidance |
|---|---|---|
Results per pagepage_size | range | Range: 12–48; step 12.Default: 24 |
Show filter swatchesshow_filter_swatches | checkbox | Uses swatch or image presentations configured in Shopify Search & Discovery. Labels and counts remain visible; missing visuals use text only. Default: false |
sections/shell-index.liquid
Editor presets: Editorial hero
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | Default: Considered objects. Lasting spaces. |
Descriptionbody | richtext | No fixed default. |
Heading levelheading_level | select | Automatic (H1 on the first homepage section) (auto); H1 (h1); H2 (h2)Default: auto |
Primary link labelbutton_label | text | Default: t:hero.button_default |
Primary linkbutton_link | url | When empty, links to all products. Clear the label to hide the link. No fixed default. |
Primary button stylebutton_style | select | Outline (outline); Filled (solid)Default: outline |
Secondary link labelsecondary_label | text | No fixed default. |
Secondary linksecondary_link | url | No fixed default. |
Media typemedia_type | select | Image (image); Video (video)Default: image |
Desktop image / video posterimage | image_picker | No fixed default. |
Mobile imagemobile_image | image_picker | Optional alternative crop for image mode. Falls back to the desktop image. No fixed default. |
Shopify-hosted videovideo | video | Plays only when the customer chooses Play. Use a silent visual clip or provide an accessible text alternative below. No fixed default. |
Video descriptionvideo_description | richtext | No fixed default. |
Media captioncaption | text | No fixed default. |
Desktop media positionmedia_side | select | Start (start); End (end)Default: end |
Desktop text positiontext_position | select | Top (start); Center (center); Bottom (end)Default: center |
Mobile ordermobile_order | select | Text first (text-first); Media first (media-first)Default: text-first |
Desktop media shapemedia_ratio | select | Portrait (4 / 5); Square (1 / 1); Landscape (3 / 2)Default: 4 / 5 |
Mobile media shapemobile_ratio | select | Portrait (4 / 5); Square (1 / 1); Landscape (3 / 2)Default: 1 / 1 |
Section paddingpadding | range | Range: 24–120; step 8; px.Default: 56 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
Hero compositioncomposition | select | Split editorial (split); Full-width image, text below (panorama); Heading above room image (room); Paired image study (paired); Immersive image campaign (campaign); Edge-to-edge color panel (panel)Default: split |
Detail imagedetail_image | image_picker | Optional second image for Paired image study. Choose a complementary close-up. No fixed default. |
Detail image captiondetail_caption | text | No fixed default. |
sections/split-narrative.liquid
Editor presets: Split narrative
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Imageimage | image_picker | No fixed default. |
Image captioncaption | text | No fixed default. |
Eyebroweyebrow | text | Default: A closer look |
Headingheading | text | Default: A study in form and texture. |
Textbody | richtext | No fixed default. |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
Desktop image positionmedia_side | select | Start (start); End (end)Default: start |
Backgroundtone | select | Page background (base); Soft surface (surface)Default: base |
Image ratioratio | select | Portrait (4 / 5); Square (1 / 1); Landscape (3 / 2)Default: 4 / 5 |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 80 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
Edge-to-edge image and text paneledge_panel | checkbox | Default: false |
detail
| Control | Type | Choices and guidance |
|---|---|---|
Labellabel | text | No fixed default. |
Detail texttext | text | No fixed default. |
sections/story-media.liquid
Editor presets: Story media, Featured video, Full-width story, Background video
Excluded placements: {"groups":["header","footer"]}
| Control | Type | Choices and guidance |
|---|---|---|
Media layoutdisplay_mode | select | Standard player (standard); Background video (background)Default: standard |
Eyebroweyebrow | text | No fixed default. |
Headingheading | text | No fixed default. |
Texttext | richtext | No fixed default. |
Imageimage | image_picker | No fixed default. |
Mobile imagemobile_image | image_picker | No fixed default. |
Video (overrides image)video | video | No fixed default. |
Captioncaption | text | No fixed default. |
Video text alternativetranscript | richtext | No fixed default. |
Full width mediafull_width | checkbox | Default: true |
Section spacingspacing | range | Range: 24–120; step 8; px.Default: 64 |
Apply section color schemeapply_color_scheme | checkbox | Turn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes. Default: false |
Color schemecolor_scheme | color_scheme | Applied only when Apply section color scheme is enabled. Choose colors with readable contrast. Default: mineral |
Video presentationbackground_presentation | select | Editorial frame places copy below the film and uses section colors. Height limits the desktop film; mobile uses a landscape crop. Dark overlay applies only to Overlay. Overlay (overlay); Editorial frame (editorial)Default: overlay |
Play automatically when visiblebackground_autoplay | checkbox | Default: true |
Height relative to viewportbackground_height | range | Range: 50–100; step 5; %.Default: 75 |
Dark overlaybackground_overlay | range | Range: 40–80; step 5; %.Default: 55 |
Content positionbackground_alignment | select | Bottom start (start); Center (center)Default: start |
Link labellink_label | text | No fixed default. |
Linklink | url | No fixed default. |
Template reference
Root templates provide storefront page types. Listing templates and section groups configure preset-specific composition. Assign alternate templates through Shopify where supported.
| File | Declared section order or role |
|---|---|
templates/404.json | 404 |
templates/article.json | article |
templates/blog.json | blog |
templates/cart.json | cart |
templates/collection.json | collection |
templates/gift_card.liquid | Liquid utility template |
templates/index.json | shell-index → featured-collections → featured-products → split-narrative → featured-products → product-spotlight → editorial-text → story-media → journal-cards → editorial-columns → editorial-newsletter → editorial-gallery → editorial-columns |
templates/list-collections.json | collections |
templates/page.brand.json | page |
templates/page.contact.json | contact |
templates/page.json | page |
templates/password.json | password |
templates/product.json | product → product-recommendations |
templates/search.json | search |
listings/auvren/sections/footer-group.json | footer → newsletter-popup |
listings/auvren/sections/header-group.json | announcement-bar → header |
listings/auvren/templates/404.json | 404 |
listings/auvren/templates/article.json | article |
listings/auvren/templates/blog.json | blog |
listings/auvren/templates/cart.json | cart |
listings/auvren/templates/collection.json | collection |
listings/auvren/templates/index.json | shell-index → featured-collections → featured-products → split-narrative → featured-products → product-spotlight → editorial-text → story-media → journal-cards → editorial-columns → editorial-newsletter → editorial-gallery → editorial-columns |
listings/auvren/templates/list-collections.json | collections |
listings/auvren/templates/page.brand.json | page |
listings/auvren/templates/page.contact.json | contact |
listings/auvren/templates/page.json | page |
listings/auvren/templates/password.json | password |
listings/auvren/templates/product.json | product → product-recommendations |
listings/auvren/templates/search.json | search |
listings/orivelle/sections/footer-group.json | footer → newsletter-popup |
listings/orivelle/sections/header-group.json | announcement-bar → header |
listings/orivelle/templates/404.json | 404 |
listings/orivelle/templates/article.json | article |
listings/orivelle/templates/blog.json | blog |
listings/orivelle/templates/cart.json | cart |
listings/orivelle/templates/collection.json | collection |
listings/orivelle/templates/index.json | shell-index → featured-products → split-narrative → featured-collections → story-media → journal-cards → editorial-columns → editorial-newsletter → editorial-gallery → editorial-columns |
listings/orivelle/templates/list-collections.json | collections |
listings/orivelle/templates/page.brand.json | page |
listings/orivelle/templates/page.contact.json | contact |
listings/orivelle/templates/page.json | page |
listings/orivelle/templates/password.json | password |
listings/orivelle/templates/product.json | product → product-recommendations |
listings/orivelle/templates/search.json | search |
listings/serein/sections/footer-group.json | footer → newsletter-popup |
listings/serein/sections/header-group.json | announcement-bar → header |
listings/serein/templates/404.json | 404 |
listings/serein/templates/article.json | article |
listings/serein/templates/blog.json | blog |
listings/serein/templates/cart.json | cart |
listings/serein/templates/collection.json | collection |
listings/serein/templates/index.json | shell-index → featured-collections → featured-products → split-narrative → product-spotlight → journal-cards → editorial-columns → editorial-newsletter → editorial-gallery → editorial-columns |
listings/serein/templates/list-collections.json | collections |
listings/serein/templates/page.brand.json | page |
listings/serein/templates/page.contact.json | contact |
listings/serein/templates/page.json | page |
listings/serein/templates/password.json | password |
listings/serein/templates/product.json | product → product-recommendations |
listings/serein/templates/search.json | search |
listings/teravo/sections/footer-group.json | footer → newsletter-popup |
listings/teravo/sections/header-group.json | announcement-bar → header |
listings/teravo/templates/404.json | 404 |
listings/teravo/templates/article.json | article |
listings/teravo/templates/blog.json | blog |
listings/teravo/templates/cart.json | cart |
listings/teravo/templates/collection.json | collection |
listings/teravo/templates/index.json | shell-index → featured-collections → featured-products → split-narrative → journal-cards → product-spotlight → editorial-columns → editorial-newsletter → editorial-gallery → editorial-columns |
listings/teravo/templates/list-collections.json | collections |
listings/teravo/templates/page.brand.json | page |
listings/teravo/templates/page.contact.json | contact |
listings/teravo/templates/page.json | page |
listings/teravo/templates/password.json | password |
listings/teravo/templates/product.json | product → product-recommendations |
listings/teravo/templates/search.json | search |
listings/veyra/sections/footer-group.json | footer → newsletter-popup |
listings/veyra/sections/header-group.json | announcement-bar → header |
listings/veyra/templates/404.json | 404 |
listings/veyra/templates/article.json | article |
listings/veyra/templates/blog.json | blog |
listings/veyra/templates/cart.json | cart |
listings/veyra/templates/collection.json | collection |
listings/veyra/templates/index.json | shell-index → featured-products → featured-collections → story-media → split-narrative → journal-cards → editorial-columns → editorial-newsletter → editorial-gallery → editorial-columns |
listings/veyra/templates/list-collections.json | collections |
listings/veyra/templates/page.brand.json | page |
listings/veyra/templates/page.contact.json | contact |
listings/veyra/templates/page.json | page |
listings/veyra/templates/password.json | password |
listings/veyra/templates/product.json | product → product-recommendations |
listings/veyra/templates/search.json | search |