AureviaTheme handbookVersion 0.1.0

Aurevia theme documentation

A considered guide
to your storefront.

Create your storefront with confidence. Explore five presets, follow practical setup guides and find the right controls for every detail.

Five presets. One theme.Setup · Customization · Store care

Merchant handbook

Start with Aurevia

Set up your storefront, explore five distinctive presets and make Aurevia your own. Start with the essentials below, then use the feature guides and settings reference as you customize.

Install and preview

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.

First setup

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.

Where settings live

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.

Replace sample content

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.

Store name and preset name

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

Five presets

All presets share Liquid, JavaScript and styling foundations. Their palettes, compositions and merchandising differ; they are not five separate themes.

Aurevia · Home & Living

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.

Serein · Beauty

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.

Veyra · Fashion

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.

Orivelle · Jewelry

Champagne, warm ivory, charcoal and gold. Use macro product photography, craftsmanship stories and gift merchandising. Document actual materials and gift-service terms.

Teravo · Lifestyle

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.

Changing presets

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.

Merchant handbook

Branding and design settings

Use a small, consistent visual system before styling individual sections.

Colors and schemes

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.

Typography and layout

Choose supported body, heading and navigation fonts. 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.

Logo and favicon

Set the logo in Header. Under Theme settings → Branding → Favicon, upload a square icon; it is requested at 32 × 32 pixels. Without a selection, the installed demo uses its bundled monogram. Browsers cache icons, so use a private window when checking changes.

Motion and responsive design

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.

Merchant handbook

Build an editorial homepage

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.

Hero and story media

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. Supply useful image alternatives and appropriate video captions. Do not use a mobile crop that hides the product or CTA.

Collections and products

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.

Narrative and text

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.

Benefits, logos and testimonials

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.

Lookbook and comparison

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.

Journal, newsletter and FAQ

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.

Collection tabs and dated promotions

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.

Featured product scale

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.

Responsive collection and spotlight images

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.

Editorial copy in presets

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.

Merchant handbook

Product pages and purchasing

Product data comes from Shopify. Product information uses reorderable blocks; available block types and controls appear in the generated section reference.

Product information blocks

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.

Gallery

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. With JavaScript disabled, media remains accessible through stacked media and image links. Verify video/3D on your actual devices.

Options and swatches

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.

Price, availability and quantity

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.

Add to cart and mobile purchase bar

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.

Subscriptions and accelerated checkout

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.

Gift cards and personalization

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, pickup and guides

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.

Specifications and recommendations

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.

Merchant handbook

Collections, search and product cards

Use native Shopify catalog and filtering capabilities. Resource availability depends on store configuration.

Collection pages

Set collection media, description, product grid and optional flat collection-navigation menu. Image overrides can support campaigns. Directory pages list collections with pagination. Breadcrumbs link back through the supported hierarchy.

Filtering and sorting

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.

Search results

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.

Product cards

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. Sold-out badges remain visible even when sale badges are disabled.

Quick add

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 heading hierarchy

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.

Merchant handbook

Cart and checkout

Configure the shopping bag, optional cart drawer and gift services, then connect your Shopify checkout settings.

Cart page

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.

Cart drawer

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.

Gift wrapping

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.

Native fallback

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.

Hosted checkout

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

Pages, footer and customer communication

Theme presentation and Shopify form handling are separate from your policies, legal obligations and fulfillment operations.

Footer

Configure brand description/short SEO copy, menu blocks, social destinations, newsletter and optional localization controls. Keep descriptions useful and accurate rather than repeating keywords. Test all links. The theme has no forced developer-credit or affiliate link.

Pages and contact

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.

Blog and articles

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.

Password, 404 and gift cards

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 and localization

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

Privacy and cookie consent

An optional theme banner records shopper choices through Shopify’s Customer Privacy API. Configure the store’s privacy requirements and integrations before enabling it.

Enable one banner

In Theme settings → Privacy and cookie consent, enable the theme cookie banner and choose all visitors or Shopify-configured consent regions. Use one consent banner at a time; do not leave a competing automatic or app banner active. The theme banner is off by default.

Configure Shopify first

Review Shopify Settings → Customer privacy, required consent regions and your privacy policy. Optional tracking permissions depend on those settings and the visitor’s region. A banner alone does not establish compliance or automatically block arbitrary app/custom scripts; ensure your integrations respect Shopify consent permissions.

Choices and preferences

Accept optional and Reject optional have equal prominence. Shoppers can instead select preferences, analytics and marketing individually. Optional choices start off unless previously granted. Essential store functions remain available. Only an explicit shopper action records a choice; dismissing, scrolling or API failures do not grant consent.

Revisit a choice

A Cookie preferences control appears in the footer when this feature is enabled. It reopens the choices so shoppers can change them. A manually reopened panel supports Escape and returns focus to its opener. The privacy-policy link uses the policy configured in Shopify.

Failures and limitations

If Shopify’s privacy service cannot load or save, the banner keeps the choice open and shows a retry path. It does not store a separate consent cookie or write Shopify cookies directly. Shopify handles its own consent persistence and applicable data-sharing signals. The theme does not change those signals as part of accepting optional cookies.

Preview and languages

Customize the banner heading and description in Theme settings. Buttons and standard descriptions use the storefront language, with English and French supplied. If consent is already recorded, use Cookie preferences to reopen the panel. Without JavaScript, the banner does not appear; your published privacy policy remains accessible through normal footer links.

Merchant handbook

Apps, privacy and advanced customization

Use native configuration before custom code. Optional capabilities should not become dependencies for basic shopping.

App blocks

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.

Custom Liquid

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.

Recently viewed

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.

Safe updates

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.

Merchant handbook

Before you publish

Use this checklist when launching your storefront or publishing a major theme update.

Brand and content

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.

Products and discovery

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.

Purchase flow

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.

Store information

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.

Accessibility and devices

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.

Publish and revisit

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

Troubleshooting and support

Start with the checks below. When contacting support, describe what you expected and what happened instead.

Wrong theme or old icon

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.

Blank sections or missing images

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.

Wrong variant or price

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.

Filter or menu problems

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.

Report an issue

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.

Merchant handbook

Updates and ongoing care

Keep a backup of your storefront and review important shopping journeys whenever your theme, apps or catalog change.

Before updating

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.

Review the updated copy

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.

Custom code and apps

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.

Find the right guidance

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.

Settings reference

Theme settings reference

Look up the controls available under Theme settings. Resource pickers connect existing Shopify content; compatible dynamic sources appear where Shopify supports them.

Branding
ControlTypeChoices and guidance
Faviconfaviconimage_pickerUpload a square icon. Displayed at 32 × 32 pixels.
No fixed default.
Typography
ControlTypeChoices and guidance
Body fonttype_primary_fontfont_pickerDefault: work_sans_n4
Heading fonttype_heading_fontfont_pickerDefault: libre_baskerville_n4
Colors
ControlTypeChoices and guidance
Backgroundbackground_colorcolorDefault: #FAF9F6
Textforeground_colorcolorDefault: #292724
Media and panelssurface_colorcolorDefault: #F0EDE7
Buttonsaccent_colorcolorDefault: #705342
Button textbutton_text_colorcolorChoose a readable contrast against the Buttons color. Outline buttons use the surrounding text color.
Default: #FFFFFF
Section color schemes
ControlTypeChoices and guidance
color_schemescolor_schemescolor_scheme_groupNo fixed default.

Fields within each scheme:

ControlTypeChoices and guidance
BackgroundbackgroundcolorDefault: #FAF9F6
Background gradientbackground_gradientcolor_backgroundOptional. Replaces the section background fill; keep text readable across the whole gradient.
No fixed default.
Text and linkstextcolorDefault: #292724
Media and panelssurfacecolorDefault: #F0EDE7
Button backgroundbuttoncolorDefault: #705342
Button textbutton_textcolorDefault: #FFFFFF
BordersbordercolorDefault: #82786F
Layout and motion
ControlTypeChoices and guidance
Content widthcontent_widthrangeRange: 1000–1600; step 50; px.Default: 1400
Section spacingsection_spacingrangeRange: 32–120; step 8; px.Default: 72
Control corner radiusinput_corner_radiusrangeRange: 0–12; step 1; px.Default: 0
Enable subtle motionenable_motioncheckboxDefault: true
Product cards
ControlTypeChoices and guidance
Image shapecard_ratioselectSquare (1 / 1); Portrait (4 / 5); Landscape (3 / 2)Default: 4 / 5
Image fitcard_image_fitselectFit 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_alignmentselectStart (start); Center (center)Default: start
Show sale badgecard_sale_badgecheckboxSold-out labels remain visible. Sale prices are always shown.
Default: true
Show vendorcard_vendorcheckboxDefault: true
Show second image on hovercard_secondarycheckboxDefault: true
Show currency codecurrency_codecheckboxDefault: true
Enable quick addcard_quick_addcheckboxAdds 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
Social links
ControlTypeChoices and guidance
Instagramsocial_instagramurlNo fixed default.
Pinterestsocial_pinteresturlNo fixed default.
Cart drawer
ControlTypeChoices and guidance
Open cart links in a drawerenable_cart_drawercheckboxDefault: false
Gift wrapping
ControlTypeChoices and guidance
Offer a gift-wrap product in the cartenable_gift_wrapcheckboxDefault: false
Gift-wrap productgift_wrap_productproductChoose a real product priced and fulfilled as your gift-wrap service. Products requiring options open their product page.
No fixed default.
Service detailsgift_wrap_texttextNo fixed default.
Recently viewed
ControlTypeChoices and guidance
Enable opt-in recently viewed productsenable_recently_viewedcheckboxAdd 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
Visual proportions
ControlTypeChoices and guidance
Heading scaleheading_scalerangeRange: 80–120; step 5; %.Default: 100
Product grid spacinggrid_gaprangeRange: 12–40; step 4; px.Default: 32
Navigation fonttype_navigation_fontfont_pickerDefault: work_sans_n4
Navigation letter spacingnavigation_spacingrangeRange: 0–3; step 0.5; px.Default: 0
Navigation text stylenavigation_caseselectAs written (none); Uppercase (uppercase)Default: none
Button corner radiusbutton_corner_radiusrangeRange: 0–24; step 2; px.Default: 0
Storefront utilities
ControlTypeChoices and guidance
Show back-to-top buttonenable_back_to_topcheckboxDefault: true
Privacy and cookie consent
ControlTypeChoices and guidance
Enable theme cookie bannerprivacy_banner_enabledcheckboxDefault: false
Show first-visit request toprivacy_banner_regionselectAll visitors (all); Visitors in Shopify-configured consent regions (shopify)Default: all
Headingprivacy_banner_headingtextNo fixed default.
Descriptionprivacy_banner_textrichtextNo fixed default.

Section reference

Section and block catalog

39 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.

Not found404

sections/404.liquid

Used within a template, section group or theme response; not available in Add section.

ControlTypeChoices and guidance
Show search formshow_searchcheckboxDefault: true
Announcement barannouncement-bar

sections/announcement-bar.liquid

Editor presets: Announcement bar

Enabled placements: {"groups":["header"]}

ControlTypeChoices and guidance
AnnouncementtexttextNo fixed default.
LinklinkurlNo fixed default.
Discount codediscount_codetextCreate and activate this code in Shopify Discounts. Displaying a code does not create a discount.
No fixed default.
Show copy-code buttoncopy_codecheckboxDefault: true
Offer link labellink_labeltextNo fixed default.
Background colorbackground_colorcolorNo fixed default.
Text colortext_colorcolorNo fixed default.
Appsapps

sections/apps.liquid

Editor presets: Apps

ControlTypeChoices and guidance
Use section spacingpaddingcheckboxDefault: true

Blocks

App block

Compatible installed apps can provide their own controls. Theme code does not define those settings.

Articlearticle

sections/article.liquid

Used within a template, section group or theme response; not available in Add section.

ControlTypeChoices and guidance
Show article imageshow_imagecheckboxDefault: true
Show publication dateshow_datecheckboxDefault: true
Show authorshow_authorcheckboxDefault: true
Show article topicsshow_tagscheckboxDefault: true
Blogblog

sections/blog.liquid

Used within a template, section group or theme response; not available in Add section.

ControlTypeChoices and guidance
Articles per pagepage_sizerangeRange: 3–24; step 3.Default: 9
Show publication dateshow_datecheckboxDefault: true
Show authorshow_authorcheckboxDefault: true
Show article excerptshow_excerptcheckboxDefault: true
Cart drawercart-drawer

sections/cart-drawer.liquid

Used within a template, section group or theme response; not available in Add section.

No individual settings are declared here.

Cartcart

sections/cart.liquid

Used within a template, section group or theme response; not available in Add section.

ControlTypeChoices and guidance
Show order noteshow_notecheckboxDefault: true
Show accelerated checkout buttonsshow_acceleratedcheckboxDefault: true
Collection tabscollection-tabs

sections/collection-tabs.liquid

Editor presets: Collection tabs

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Items to showlimitrangeRange: 2–12; step 1.Default: 4
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Blocks

Collection

collection

ControlTypeChoices and guidance
CollectioncollectioncollectionNo fixed default.
Tab label (optional)labeltextNo fixed default.
Collectioncollection

sections/collection.liquid

Used within a template, section group or theme response; not available in Add section.

ControlTypeChoices and guidance
Show breadcrumbsshow_breadcrumbscheckboxDefault: true
Show collection imageshow_imagecheckboxDefault: true
Collection image overrideimageimage_pickerUses the collection image when no override is selected.
No fixed default.
Show collection descriptionshow_descriptioncheckboxDefault: true
Results per pagepage_sizerangeRange: 12–48; step 12.Default: 24
Show filter swatchesshow_filter_swatchescheckboxUses swatch or image presentations configured in Shopify Search & Discovery. Labels and counts remain visible; missing visuals use text only.
Default: false
Collection navigation menunavigation_menulink_listDisplays 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_imagescheckboxDefault: false
Collections gridcollections

sections/collections.liquid

Editor presets: Collections grid

ControlTypeChoices and guidance
Grid item widthgrid_item_widthselectSmall (collections--compact); Large (collections--full)Default: collections--full
Grid spacinggrid_gaprangeRange: 0–50; step 5; px.Default: 10
Show breadcrumbsshow_breadcrumbscheckboxDefault: true
Show collection descriptionshow_descriptioncheckboxDefault: true
Show product countsshow_countcheckboxDefault: false
Results per pagepage_sizerangeRange: 12–48; step 12.Default: 24
Contact formcontact

sections/contact.liquid

Used within a template, section group or theme response; not available in Add section.

Enabled placements: {"templates":["page"]}

ControlTypeChoices and guidance
Heading overrideheadingtextNo fixed default.
Show page contentshow_page_contentcheckboxDefault: true
Additional introductionintroductionrichtextNo fixed default.
Show optional phone fieldshow_phonecheckboxDefault: true
Custom Liquidcustom-liquid

sections/custom-liquid.liquid

Editor presets: Custom Liquid

ControlTypeChoices and guidance
Liquidcustom_liquidliquidNo fixed default.
Custom sectioncustom-section

sections/custom-section.liquid

Editor presets: Custom section

ControlTypeChoices and guidance
Backgroundbackground_imageimage_pickerNo fixed default.

Blocks

@theme

No individual settings are declared here.

Dated promotiondated-promotion

sections/dated-promotion.liquid

Editor presets: Dated promotion

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Link labellink_labeltextNo fixed default.
LinklinkurlNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
End date and timedeadlinetextUse 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_countdowncheckboxDefault: false
Text after deadlineended_texttextNo fixed default.
Editorial columnseditorial-columns

sections/editorial-columns.liquid

Editor presets: Benefits, Logo row, Testimonials

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Blocks

Benefit

benefit

ControlTypeChoices and guidance
Imageimageimage_pickerNo fixed default.
TitletitletextNo fixed default.
TexttextrichtextNo fixed default.
Link labellink_labeltextNo fixed default.
LinklinkurlNo fixed default.

Logo

logo

ControlTypeChoices and guidance
Imageimageimage_pickerNo fixed default.
TitletitletextNo fixed default.
Link labellink_labeltextNo fixed default.
LinklinkurlNo fixed default.

Merchant testimonial

testimonial

ControlTypeChoices and guidance
TexttextrichtextNo fixed default.
TitletitletextNo fixed default.
FAQeditorial-faq

sections/editorial-faq.liquid

Editor presets: FAQ

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Blocks

Question

question

ControlTypeChoices and guidance
QuestionquestiontextNo fixed default.
AnsweranswerrichtextNo fixed default.
Newslettereditorial-newsletter

sections/editorial-newsletter.liquid

Editor presets: Newsletter

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
Rich text and quoteeditorial-text

sections/editorial-text.liquid

Editor presets: Rich text and quote, Editorial quote

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Display text as a quotequotecheckboxDefault: false
Quote attributionattributiontextNo fixed default.
AlignmentalignmentselectStart (start); Center (center)Default: center
Link labellink_labeltextNo fixed default.
LinklinkurlNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
Cart previewheader-cart-preview

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.

Headerheader

sections/header.liquid

Used within a template, section group or theme response; not available in Add section.

Enabled placements: {"groups":["header"]}

ControlTypeChoices and guidance
Show cart preview on desktop hoverenable_cart_previewcheckboxDefault: true
Logologoimage_pickerNo fixed default.
Main menumenulink_listDefault: main-menu
Keep header visiblestickycheckboxDefault: true
Customer account menucustomer_account_menulink_listDefault: customer-account-main-menu
Apply section color schemeapply_color_schemecheckboxDefault: false
Color schemecolor_schemecolor_schemeDefault: mineral
Desktop header layoutdesktop_layoutselectStacked (stacked); Inline (inline)Default: stacked

Blocks

Menu promotion

menu_promotion

ControlTypeChoices and guidance
Parent menu destinationmenu_itemurlChoose 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)imageimage_pickerNo fixed default.
HeadingheadingtextNo fixed default.
Short descriptiontexttextNo fixed default.
Promotion destinationlinkurlNo fixed default.
Before / after imagesimage-comparison

sections/image-comparison.liquid

Editor presets: Before / after images

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
First imagebefore_imageimage_pickerNo fixed default.
First image labelbefore_labeltextNo fixed default.
Second imageafter_imageimage_pickerNo fixed default.
Second image labelafter_labeltextNo fixed default.
Desktop image ratioratioselectSquare (1); Landscape (3:2) (1.5); Portrait (4:5) (0.8)Default: 1.5
Mobile image ratiomobile_ratioselectSquare (1); Landscape (3:2) (1.5); Portrait (4:5) (0.8)Default: 1
Initial first-image revealpositionrangeRange: 0–100; step 5; %.Default: 50
Image lookbookimage-lookbook

sections/image-lookbook.liquid

Editor presets: Image lookbook

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Imageimageimage_pickerNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Blocks

Product hotspot

hotspot

ControlTypeChoices and guidance
ProductproductproductNo fixed default.
Horizontal positionxrangeRange: 5–95; step 1; %.Default: 50
Vertical positionyrangeRange: 5–95; step 1; %.Default: 50
Journal cardsjournal-cards

sections/journal-cards.liquid

Editor presets: Journal cards

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
BlogblogblogNo fixed default.
Items to showlimitrangeRange: 2–6; step 1.Default: 3
Link labellink_labeltextNo fixed default.
LinklinkurlNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
Pagepage

sections/page.liquid

Used within a template, section group or theme response; not available in Add section.

ControlTypeChoices and guidance
Show page titleshow_titlecheckboxDefault: true
Use wide content areawidecheckboxDefault: false
Passwordpassword

sections/password.liquid

Used within a template, section group or theme response; not available in Add section.

ControlTypeChoices and guidance
Heading overrideheadingtextNo fixed default.
Additional introductionintroductionrichtextNo fixed default.
Product comparisonproduct-comparison

sections/product-comparison.liquid

Editor presets: Product comparison

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Product 1product_1productNo fixed default.
Product 2product_2productNo fixed default.
Product 3product_3productNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Blocks

Comparison row

row

ControlTypeChoices and guidance
LabellabeltextNo fixed default.
Value for product 1value_1richtextNo fixed default.
Value for product 2value_2richtextNo fixed default.
Value for product 3value_3richtextNo fixed default.
Product recommendationsproduct-recommendations

sections/product-recommendations.liquid

Editor presets: Product recommendations

Enabled placements: {"templates":["product"]}

ControlTypeChoices and guidance
HeadingheadingtextDefault: Consider these, too.
EyebroweyebrowtextNo fixed default.
Recommendation typeintentselectRelated products (related); Complementary products (complementary)Default: related
Product countlimitrangeRange: 2–10; step 1.Default: 4
Fallback productsfallback_productsproduct_listNo fixed default.
Link labellink_labeltextNo fixed default.
Optional linklinkurlNo fixed default.
Product specificationsproduct-specifications

sections/product-specifications.liquid

Editor presets: Product specifications

Enabled placements: {"templates":["product"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextLeave blank to use the translated Specifications heading.
No fixed default.
IntroductiontextrichtextNo fixed default.
Desktop layoutlayoutselectHeading beside specifications (split); Heading above specifications (stacked)Default: split
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Blocks

Specification row

specification

ControlTypeChoices and guidance
LabellabeltextNo fixed default.
ValuevaluerichtextEnter 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.
Product spotlightproduct-spotlight

sections/product-spotlight.liquid

Editor presets: Product spotlight

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
ProductproductproductNo fixed default.
Empty collection labelplaceholdertextDefault: Product spotlight
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
Show purchase controlsshow_purchasecheckboxAdds 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_checkoutcheckboxDefault: false
Show option swatchesshow_option_swatchescheckboxUses color or image swatches configured for product option values in Shopify. Names stay visible; values without swatch data use text buttons.
Default: false

Blocks

App block

Compatible installed apps can provide their own controls. Theme code does not define those settings.

Custom Liquid

custom_liquid

ControlTypeChoices and guidance
Liquid codecontentliquidNo fixed default.
Productproduct

sections/product.liquid

Used within a template, section group or theme response; not available in Add section.

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
Show mobile purchase barsticky_purchasecheckboxDefault: false
Show option swatchesshow_option_swatchescheckboxUses color or image swatches configured for product option values in Shopify. Names stay visible; values without swatch data use text buttons.
Default: false
Desktop gallery widthgallery_widthselectBalanced (balanced); Wide (wide)Default: balanced
Image ratiogallery_ratioselectSquare (square); Portrait (4:5) (portrait); Original image ratio (natural)Default: square
Desktop thumbnail placementgallery_thumbnailsselectBelow media (below); Beside media (side)Default: below
Show breadcrumbsshow_breadcrumbscheckboxDefault: false

Blocks

App block

Compatible installed apps can provide their own controls. Theme code does not define those settings.

Title

title · Per-type limit: 1

ControlTypeChoices and guidance
Show vendorshow_vendorcheckboxDefault: true

Price and availability

price · Per-type limit: 1

No individual settings are declared here.

Purchase controls

purchase · Per-type limit: 1

ControlTypeChoices and guidance
Show accelerated checkoutdynamic_checkoutcheckboxDefault: true
Show gift-card recipient fieldsshow_recipientcheckboxDefault: true

Description

description · Per-type limit: 1

No individual settings are declared here.

Text

text

ControlTypeChoices and guidance
TexttextrichtextNo fixed default.

Collapsible information

accordion

ControlTypeChoices and guidance
HeadingheadingtextDefault: Product details
ContentcontentrichtextNo fixed default.

Pickup availability

pickup · Per-type limit: 1

No individual settings are declared here.

Size or material guide

guide

ControlTypeChoices and guidance
HeadingheadingtextNo fixed default.
Guide pagepagepagePage content takes precedence over the text below. Use a page for measurement tables.
No fixed default.
ContentcontentrichtextNo fixed default.

Custom Liquid

custom_liquid

ControlTypeChoices and guidance
Liquid codecontentliquidNo fixed default.

Inventory information

inventory · Per-type limit: 1

ControlTypeChoices and guidance
Show tracked inventory countshow_countcheckboxDefault: false
Show expected incoming dateshow_incomingcheckboxDefault: false

Personalization field

personalization

ControlTypeChoices and guidance
Field labellabeltextUse a unique label per field. This becomes the cart line-item property name. Requires a purchase block.
No fixed default.
Help texthelptextNo fixed default.
RequiredrequiredcheckboxDefault: false
Maximum charactersmax_lengthrangeRange: 10–200; step 10.Default: 100

Shipping and returns

policies · Per-type limit: 1

ControlTypeChoices and guidance
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Show contextual tax informationshow_tax_informationcheckboxDefault: true
Recently viewed cardrecently-viewed-card

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.

Recently viewedrecently-viewed

sections/recently-viewed.liquid

Editor presets: Recently viewed

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
Items to showlimitrangeRange: 2–6; step 1.Default: 4
Editorial heroshell-index

sections/shell-index.liquid

Editor presets: Editorial hero

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextDefault: Considered objects. Lasting spaces.
DescriptionbodyrichtextNo fixed default.
Heading levelheading_levelselectAutomatic (H1 on the first homepage section) (auto); H1 (h1); H2 (h2)Default: auto
Primary link labelbutton_labeltextDefault: t:hero.button_default
Primary linkbutton_linkurlWhen empty, links to all products. Clear the label to hide the link.
No fixed default.
Primary button stylebutton_styleselectOutline (outline); Filled (solid)Default: outline
Secondary link labelsecondary_labeltextNo fixed default.
Secondary linksecondary_linkurlNo fixed default.
Media typemedia_typeselectImage (image); Video (video)Default: image
Desktop image / video posterimageimage_pickerNo fixed default.
Mobile imagemobile_imageimage_pickerOptional alternative crop for image mode. Falls back to the desktop image.
No fixed default.
Shopify-hosted videovideovideoPlays only when the customer chooses Play. Use a silent visual clip or provide an accessible text alternative below.
No fixed default.
Video descriptionvideo_descriptionrichtextNo fixed default.
Media captioncaptiontextNo fixed default.
Desktop media positionmedia_sideselectStart (start); End (end)Default: end
Desktop text positiontext_positionselectTop (start); Center (center); Bottom (end)Default: center
Mobile ordermobile_orderselectText first (text-first); Media first (media-first)Default: text-first
Desktop media shapemedia_ratioselectPortrait (4 / 5); Square (1 / 1); Landscape (3 / 2)Default: 4 / 5
Mobile media shapemobile_ratioselectPortrait (4 / 5); Square (1 / 1); Landscape (3 / 2)Default: 1 / 1
Section paddingpaddingrangeRange: 24–120; step 8; px.Default: 56
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral
Hero compositioncompositionselectSplit editorial (split); Full-width image, text below (panorama)Default: split
Split narrativesplit-narrative

sections/split-narrative.liquid

Editor presets: Split narrative

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
Imageimageimage_pickerNo fixed default.
Image captioncaptiontextNo fixed default.
EyebroweyebrowtextDefault: A closer look
HeadingheadingtextDefault: A study in form and texture.
TextbodyrichtextNo fixed default.
Link labellink_labeltextNo fixed default.
LinklinkurlNo fixed default.
Desktop image positionmedia_sideselectStart (start); End (end)Default: start
BackgroundtoneselectPage background (base); Soft surface (surface)Default: base
Image ratioratioselectPortrait (4 / 5); Square (1 / 1); Landscape (3 / 2)Default: 4 / 5
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 80
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Blocks

Detail

detail

ControlTypeChoices and guidance
LabellabeltextNo fixed default.
Detail texttexttextNo fixed default.
Story mediastory-media

sections/story-media.liquid

Editor presets: Story media, Featured video, Full-width story

Excluded placements: {"groups":["header","footer"]}

ControlTypeChoices and guidance
EyebroweyebrowtextNo fixed default.
HeadingheadingtextNo fixed default.
TexttextrichtextNo fixed default.
Imageimageimage_pickerNo fixed default.
Mobile imagemobile_imageimage_pickerNo fixed default.
Video (overrides image)videovideoNo fixed default.
CaptioncaptiontextNo fixed default.
Video text alternativetranscriptrichtextNo fixed default.
Full width mediafull_widthcheckboxDefault: true
Section spacingspacingrangeRange: 24–120; step 8; px.Default: 64
Apply section color schemeapply_color_schemecheckboxTurn off to keep the existing global colors and section tone. Edit reusable palettes in Theme settings > Section color schemes.
Default: false
Color schemecolor_schemecolor_schemeApplied only when Apply section color scheme is enabled. Choose colors with readable contrast.
Default: mineral

Template reference

Templates and preset compositions

Root templates provide storefront page types. Listing templates and section groups configure preset-specific composition. Assign alternate templates through Shopify where supported.

FileDeclared section order or role
templates/404.json404
templates/article.jsonarticle
templates/blog.jsonblog
templates/cart.jsoncart
templates/collection.jsoncollection
templates/gift_card.liquidLiquid utility template
templates/index.jsonshell-index → featured-collections → split-narrative → featured-products → editorial-text
templates/list-collections.jsoncollections
templates/page.contact.jsoncontact
templates/page.jsonpage
templates/password.jsonpassword
templates/product.jsonproduct → product-recommendations
templates/search.jsonsearch
listings/aurevia/sections/footer-group.jsonfooter
listings/aurevia/sections/header-group.jsonannouncement-bar → header
listings/aurevia/templates/404.json404
listings/aurevia/templates/article.jsonarticle
listings/aurevia/templates/blog.jsonblog
listings/aurevia/templates/cart.jsoncart
listings/aurevia/templates/collection.jsoncollection
listings/aurevia/templates/index.jsonshell-index → featured-collections → featured-products → split-narrative → product-spotlight → editorial-text
listings/aurevia/templates/list-collections.jsoncollections
listings/aurevia/templates/page.contact.jsoncontact
listings/aurevia/templates/page.jsonpage
listings/aurevia/templates/password.jsonpassword
listings/aurevia/templates/product.jsonproduct → product-recommendations
listings/aurevia/templates/search.jsonsearch
listings/orivelle/sections/footer-group.jsonfooter
listings/orivelle/sections/header-group.jsonannouncement-bar → header
listings/orivelle/templates/404.json404
listings/orivelle/templates/article.jsonarticle
listings/orivelle/templates/blog.jsonblog
listings/orivelle/templates/cart.jsoncart
listings/orivelle/templates/collection.jsoncollection
listings/orivelle/templates/index.jsonshell-index → featured-products → featured-collections → split-narrative → story-media → product-spotlight
listings/orivelle/templates/list-collections.jsoncollections
listings/orivelle/templates/page.contact.jsoncontact
listings/orivelle/templates/page.jsonpage
listings/orivelle/templates/password.jsonpassword
listings/orivelle/templates/product.jsonproduct → product-recommendations
listings/orivelle/templates/search.jsonsearch
listings/serein/sections/footer-group.jsonfooter
listings/serein/sections/header-group.jsonannouncement-bar → header
listings/serein/templates/404.json404
listings/serein/templates/article.jsonarticle
listings/serein/templates/blog.jsonblog
listings/serein/templates/cart.jsoncart
listings/serein/templates/collection.jsoncollection
listings/serein/templates/index.jsonshell-index → featured-products → split-narrative → featured-collections → editorial-text → product-spotlight
listings/serein/templates/list-collections.jsoncollections
listings/serein/templates/page.contact.jsoncontact
listings/serein/templates/page.jsonpage
listings/serein/templates/password.jsonpassword
listings/serein/templates/product.jsonproduct → product-recommendations
listings/serein/templates/search.jsonsearch
listings/teravo/sections/footer-group.jsonfooter
listings/teravo/sections/header-group.jsonannouncement-bar → header
listings/teravo/templates/404.json404
listings/teravo/templates/article.jsonarticle
listings/teravo/templates/blog.jsonblog
listings/teravo/templates/cart.jsoncart
listings/teravo/templates/collection.jsoncollection
listings/teravo/templates/index.jsonshell-index → featured-collections → featured-products → split-narrative → journal-cards → editorial-text
listings/teravo/templates/list-collections.jsoncollections
listings/teravo/templates/page.contact.jsoncontact
listings/teravo/templates/page.jsonpage
listings/teravo/templates/password.jsonpassword
listings/teravo/templates/product.jsonproduct → product-recommendations
listings/teravo/templates/search.jsonsearch
listings/veyra/sections/footer-group.jsonfooter
listings/veyra/sections/header-group.jsonannouncement-bar → header
listings/veyra/templates/404.json404
listings/veyra/templates/article.jsonarticle
listings/veyra/templates/blog.jsonblog
listings/veyra/templates/cart.jsoncart
listings/veyra/templates/collection.jsoncollection
listings/veyra/templates/index.jsonshell-index → featured-collections → story-media → featured-products → product-spotlight → split-narrative
listings/veyra/templates/list-collections.jsoncollections
listings/veyra/templates/page.contact.jsoncontact
listings/veyra/templates/page.jsonpage
listings/veyra/templates/password.jsonpassword
listings/veyra/templates/product.jsonproduct → product-recommendations
listings/veyra/templates/search.jsonsearch