Sections
Every section the theme ships. “Added by you” means the section has a preset, so it appears in the theme editor’s Add section menu; the rest are fixed parts of a template or a section group.
IDs are the file name in sections/, which is also what appears in a template’s JSON.
| Section | Added by you | Settings |
|---|---|---|
| Not found | No — part of a fixed layout | 0 |
| Announcement bar | Yes | 5 |
| Article | No — part of a fixed layout | 7 |
| Image banner | Yes | 18 |
| Blog | No — part of a fixed layout | 8 |
| Cart drawer | No — part of a fixed layout | 0 |
| Cart | No — part of a fixed layout | 3 |
| Collection list | Yes | 13 |
| Collection | No — part of a fixed layout | 20 |
| Collections grid | Yes | 4 |
| Contact form | Yes | 8 |
| Custom Liquid | Yes | 3 |
| Custom section | Yes | 1 |
| FAQ | Yes | 4 |
| Featured collection | Yes | 22 |
| Featured product | Yes | 14 |
| Footer | No — part of a fixed layout | 9 |
| Header | No — part of a fixed layout | 18 |
| Hero | Yes | 24 |
| Hotspot image | Yes | 5 |
| Image with text | Yes | 11 |
| Logo list | Yes | 5 |
| Product information | Yes | 17 |
| Newsletter | Yes | 7 |
| Page | No — part of a fixed layout | 0 |
| Password | No — part of a fixed layout | 0 |
| Pickup availability | No — part of a fixed layout | 0 |
| Header search | No — part of a fixed layout | 5 |
| Predictive search | Yes | 8 |
| Promo panel | Yes | 10 |
| Provenance timeline | Yes | 6 |
| Quick view | No — part of a fixed layout | 0 |
| Quick view | No — part of a fixed layout | 1 |
| Recently viewed | No — part of a fixed layout | 5 |
| Recently viewed | Yes | 7 |
| Related products | Yes | 12 |
| Reviews | Yes | 5 |
| Rich text | Yes | 9 |
| Search | No — part of a fixed layout | 14 |
| Specification matrix | Yes | 8 |
| Split banner | Yes | 14 |
| Tabbed collections | Yes | 20 |
| Video | Yes | 14 |
404
Not found
- Ships in:
404
No settings.
announcement-bar
Announcement bar
- Ships in:
header-group - Presets: Announcement bar
- Only available in the header group.
- Accepts blocks: message
- Maximum 12 blocks.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Background | bg_color | color | #1A1A1A | — |
| Text | text_color | color | #FAF9F6 | — |
| Animation Style | animation_style | select | fade | Options: Fade, Loop Text |
| Seconds per message | rotation_speed | range | 4 | 2–10 s, step 1 |
| Pause on hover | pause_on_hover | checkbox | true | — |
article
Article
- Ships in:
article - Only available on: article
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show breadcrumbs | show_breadcrumbs | checkbox | true | — |
| Show image | show_image | checkbox | true | — |
| Show author | show_author | checkbox | true | — |
| Show tags | show_tags | checkbox | true | — |
| Show previous/next links | show_pagination | checkbox | true | — |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 48 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
banner
Image banner
- Not in any default template — add it from Add section.
- Presets: Image banner
Image
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Desktop image | image | image_picker | — | — |
| Mobile image | mobile_image | image_picker | — | Falls back to the desktop image when not set |
| Alt text | image_alt | text | — | — |
| Image overlay | overlay_opacity | range | 35 | Darkens the image behind the text. Raise it when the photograph is busy or light. 0–80 %, step 5 |
Content
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Subheading | subheading | text | — | — |
| Heading | heading | text | — | — |
| Heading size | heading_size | select | m | Options: Small, Medium, Large |
| Text | text | richtext | — | — |
Buttons
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Button label | button_label | text | — | — |
| Button link | button_link | url | — | — |
| Button style | button_style | select | solid | Outline reads over photography; a solid button can disappear into a dark image. Options: Solid, Outline (no background), No button |
| Second button label | button_label_2 | text | — | — |
| Second button link | button_link_2 | url | — | — |
| Second button style | button_style_2 | select | outline | Options: Outline (no background), Solid, No button |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Banner height | height | select | medium | Options: Adapt to image, Small, Medium, Large, Full screen |
| Content position | content_position | select | middle | Options: Top, Middle, Bottom center |
| Text alignment | text_alignment | select | center | Options: Left, Center, Right |
| Show text below image on mobile | stack_on_mobile | checkbox | false | Moves the heading and buttons off the photograph on small screens |
blog
Blog
- Ships in:
blog - Only available on: blog
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Articles per page | articles_per_page | range | 9 | 3–24, step 3 |
| Products per row | desktop_columns | range | 3 | 2–4, step 1 |
Content
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show image | show_image | checkbox | true | — |
| Show author | show_author | checkbox | true | — |
| Show description | show_excerpt | checkbox | true | — |
| Show comment count | show_comment_count | checkbox | false | — |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 48 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
cart-drawer
Cart drawer
- Ships in:
overlay-group - Accepts blocks: custom-liquid,
@app(blocks from installed apps)
No settings.
cart
Cart
- Ships in:
cart
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Selected specimens | Small tracked label shown above the heading |
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
collection-list
Collection list
- Ships in:
index - Presets: Fabric Taxonomy Grid
- Accepts blocks: collection-card
- Maximum 12 blocks.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Material science | Small tracked label shown above the heading |
| Heading | heading | text | Fabric taxonomy & raw specs | — |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Desktop layout | desktop_layout | select | grid | Options: Grid, Slider |
| Collections per row | desktop_columns | range | 3 | 2–6, step 1 |
| Mobile layout | mobile_layout | select | slider | Options: Grid, Slider |
| Mobile columns | mobile_columns | select | 1 | Options: 1 column, 2 columns |
| Gap between cards | card_gap | range | 32 | 0–64 px, step 4 |
| Show arrows on desktop | show_arrows_desktop | checkbox | true | — |
| Show arrows on mobile | show_arrows_mobile | checkbox | false | — |
Card style
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | card_size | select | landscape | Options: Portrait, Square, Landscape |
| Image source | image_source | select | collection | Choose which image represents the collection on the card. Options: Collection image, First product image |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
collection
Collection
- Ships in:
collection
Banner
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show banner | show_banner | checkbox | true | — |
| Banner image | banner_image | image_picker | — | Defaults to the collection’s own image if left blank |
| Banner height | banner_height | range | 320 | 160–560 px, step 20 |
| Image overlay | banner_overlay_opacity | range | 30 | 0–80 %, step 5 |
| Show description | show_description | checkbox | true | — |
| Show breadcrumbs | show_breadcrumbs | checkbox | true | — |
| Eyebrow label | eyebrow | text | Index catalogue | Small tracked label shown above the heading |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Products per row | desktop_columns | range | 4 | 2–5, step 1 |
| Mobile columns | mobile_columns | select | 2 | Options: 1 column, 2 columns |
| Gap between cards | card_gap | range | 0 | 0–64 px, step 4 |
Product card
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | image_ratio | select | portrait | Options: Portrait, Square, Landscape, Adapt to image |
| Hover effect | image_hover | select | second_image | Options: None, Show second image |
| Show colour swatches | show_swatches | checkbox | true | — |
| Colour option name | swatch_option_name | text | Color-Colour-color-colour | Separate several accepted names with hyphens, e.g. Color-Colour |
| Show compare-at price | show_compare_price | checkbox | true | — |
| Show sale badge | show_sale_badge | checkbox | true | — |
| Show quick-view icon | show_quick_view | checkbox | true | — |
| Show add to cart button | show_add_button | checkbox | false | Adds the first available variant instantly with one click. For products with multiple options (e.g. size and color), this may not be the exact variant a customer wants — consider enabling quick view instead so they can choose first |
Pagination
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Pagination style | pagination_style | select | pages | Options: Numbered pages, Load more button |
| Products per page | products_per_page | range | 24 | 8–48, step 4 |
collections
Collections grid
- Ships in:
list-collections - Presets: Collections grid
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show breadcrumbs | show_breadcrumbs | checkbox | true | — |
| Products per row | desktop_columns | range | 3 | 2–5, step 1 |
| Mobile columns | mobile_columns | select | 1 | Options: 1 column, 2 columns |
| Gap between cards | grid_gap | range | 25 | 0–50 px, step 5 |
contact-form
Contact form
- Ships in:
page.contact - Presets: Contact form
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Get in touch | — |
| Subheading | subtext | richtext | — | — |
| Show phone field | show_phone | checkbox | false | — |
| Button label | button_label | text | Send | — |
| Narrow width | narrow | checkbox | true | — |
| Alignment | alignment | select | left | Options: Left, Center |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
custom-liquid
Custom Liquid
- Not in any default template — add it from Add section.
- Presets: Custom Liquid
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Liquid code | custom_liquid | liquid | — | Add app snippets or other Liquid code to create advanced customizations |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 0 | 0–100 px, step 4 |
| Bottom padding | padding_bottom | range | 0 | 0–100 px, step 4 |
custom-section
Custom section
- Not in any default template — add it from Add section.
- Presets: Custom section
- Accepts blocks:
@theme(any theme block)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Background | background_image | image_picker | — | — |
faq
FAQ
- Ships in:
index,page.authenticity,page.care,page.materials,page.specifications - Presets: FAQ
- Accepts blocks: faq-item
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Frequently asked questions | — |
| Heading size | heading_size | select | m | Options: Small, Medium, Large |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
featured-collection
Featured collection
- Ships in:
index - Presets: Featured collection
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | — | — |
| Heading size | heading_size | select | m | Options: Small, Medium, Large |
| Collection | collection | collection | — | — |
| Products to show | products_to_show | range | 8 | 2–16, step 1 |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Desktop layout | desktop_layout | select | grid | Options: Grid, Carousel |
| Products per row | desktop_columns | range | 4 | 2–5, step 1 |
| Mobile layout | mobile_layout | select | carousel | Options: Grid, Carousel |
| Mobile columns | mobile_columns | select | 1 | Options: 1 column, 2 columns |
| Show arrows | show_arrows | checkbox | true | — |
| Show arrows on mobile | show_arrows_mobile | checkbox | false | Off relies on swipe alone for a cleaner look on small screens |
| Gap between cards | card_gap | range | 0 | 0–64 px, step 4 |
Product card
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | image_ratio | select | portrait | Options: Portrait, Square, Landscape, Adapt to image |
| Hover effect | image_hover | select | second_image | Options: None, Show second image |
| Show colour swatches | show_swatches | checkbox | true | — |
| Colour option name | swatch_option_name | text | Color-Colour-color-colour | Separate several accepted names with hyphens, e.g. Color-Colour |
| Show compare-at price | show_compare_price | checkbox | true | — |
| Show sale badge | show_sale_badge | checkbox | true | — |
| Show quick-view icon | show_quick_view | checkbox | false | — |
| Show add to cart button | show_add_button | checkbox | false | Adds the first available variant instantly with one click. For products with multiple options (e.g. size and color), this may not be the exact variant a customer wants — consider enabling quick view instead so they can choose first |
| Text alignment | card_text_alignment | select | left | Options: Left, Center |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
featured-product
Featured product
- Not in any default template — add it from Add section.
- Presets: Featured product
- Accepts blocks: custom-liquid,
@app(blocks from installed apps)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | — | — |
| Heading size | heading_size | select | m | Options: Small, Medium, Large |
| Product | product | product | — | — |
Media
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Media position | media_layout | select | left | Options: Left, Right |
| Media width | media_width | range | 55 | 45–70 %, step 5 |
| Image ratio | image_ratio | select | adapt | Options: Adapt to image, Portrait, Square, Landscape |
| Thumbnail position | thumb_position | select | below | Options: Below, Left |
| Enable image zoom | enable_zoom | checkbox | true | — |
Content
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show vendor | show_vendor | checkbox | false | — |
| Show description | show_description | checkbox | true | — |
| Show quantity selector | show_quantity | checkbox | false | — |
| Show dynamic checkout buttons | show_dynamic_checkout | checkbox | true | Lets customers check out directly with Shop Pay, PayPal and other accelerated options |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
footer
Footer
- Ships in:
footer-group - Accepts blocks: footer-logo, footer-menu, footer-newsletter, footer-text
Colors
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Background | background | color | #FFFFFF | — |
| Foreground | text_color | color | #1A1A1A | — |
Content
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show accepted payment methods | show_payment_icons | checkbox | true | Uses the payment providers enabled in Settings > Payments |
| Payment icons image | payment_image | image_picker | — | Optional. Replaces the automatic payment logos with your own image. Shown when show_payment_icons |
| Show store policy links | show_policy_links | checkbox | true | Shows your published Privacy, Refund, Terms and Shipping policies |
| Show “Powered by Shopify” | show_powered_by | checkbox | true | — |
| Show “Follow on Shop” button | show_follow_on_shop | checkbox | true | Lets customers follow your store in the Shop app. Only appears when the Shop sales channel is set up |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
header
Header
- Ships in:
header-group - Accepts blocks: promo-bar
Logo
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Logo position | logo_position | select | left | Options: Left, Middle |
Menu
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Menu | menu | link_list | main-menu | — |
| Desktop menu type | desktop_menu_type | select | dropdown | Options: Dropdown, Mega menu, Drawer (hamburger) |
| Customer account menu | customer_account_menu | link_list | customer-account-main-menu | — |
Sticky header
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Sticky behavior | sticky | select | always | Options: None, Always, On scroll up, Always, reduce logo size |
Utility bar
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Utility bar style | top_bar_style | select | ink | Options: Paper, Ink (inverted) |
| System note | top_bar_note | text | Batch 04 / 100 now indexed | A short status line shown beside a live indicator, e.g. “Batch 04/100 now indexed” |
| Hide top bar on scroll | hide_top_bar_on_scroll | checkbox | false | Collapses the top utility bar (offer chip, social links, country selector) once the page is scrolled, keeping only the main header row pinned |
Colors
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Background | bg_color | color | #FFFFFF | — |
| Foreground | text_color | color | #1A1A1A | — |
Float over the first section
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Float over the first section | enable_transparent | checkbox | false | The header overlays the first section transparently on the home page only, then becomes solid once you scroll past it. Other templates always use the solid background. Only use this over a dark image, and check the text color below is readable against it — light text on a light hero fails accessibility |
| Text color while floating | transparent_text_color | color | #FFFFFF | — |
| Logo while floating | transparent_logo | image_picker | — | Shown instead of the default logo while the header is floating transparently. Falls back to the default logo when not set |
Options
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show search icon | show_search | checkbox | true | — |
| Show country/region selector | show_country | checkbox | false | Appears in the utility bar above the header. Only shown when the store sells to more than one country |
| Show language selector | show_language | checkbox | false | Appears in the utility bar above the header. Only shown when the store has published more than one language |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 16 | 0–60 px, step 2 |
| Bottom padding | padding_bottom | range | 16 | 0–60 px, step 2 |
hero
Hero
- Ships in:
index - Presets: Hero
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image | image | image_picker | — | — |
| Image alt text | image_alt | text | — | — |
| Eyebrow label | tag | text | Specimen no. 042 | Small tracked label shown above the heading |
| Heading | title | text | Architectural <em>garment</em> engineering | — |
| Text | text | textarea | A physical exploration into heavy organic twill, unbleached canvas structural lines, and custom cold-forged brass fittings. | — |
Technical spec table
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Spec label | spec_label_1 | text | Material | — |
| Spec value | spec_val_1 | text | 480 gsm heavy twill | — |
| Spec label | spec_label_2 | text | Hardware | — |
| Spec value | spec_val_2 | text | Cold-forged brass | — |
| Spec label | spec_label_3 | text | Production run | — |
| Spec value | spec_val_3 | text | Strictly 150 pieces | — |
Blueprint pins
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Prompt before a pin is selected | dossier_prompt | textarea | Select a pin on the garment to inspect its engineering detail. | — |
| Pin title | pin_1_title | text | Reinforced seam | — |
| Pin description | pin_1_desc | text | Triple-needle chain stitch on stress vectors. | — |
| Vertical | pin_1_top | range | 32 | 5–95 %, step 1 |
| Horizontal | pin_1_left | range | 45 | 5–95 %, step 1 |
| Pin title | pin_2_title | text | Brass hardware | — |
| Pin description | pin_2_desc | text | Solid unlacquered raw brass button closure. | — |
| Vertical | pin_2_top | range | 62 | 5–95 %, step 1 |
| Horizontal | pin_2_left | range | 28 | 5–95 %, step 1 |
| Pin title | pin_3_title | text | Heavy hem | — |
| Pin description | pin_3_desc | text | 4-inch weighted fold hem with raw edge finish. | — |
| Vertical | pin_3_top | range | 78 | 5–95 %, step 1 |
| Horizontal | pin_3_left | range | 62 | 5–95 %, step 1 |
hotspot-image
Hotspot image
- Ships in:
index - Presets: Hotspot image
- Accepts blocks: hotspot
- Maximum 6 blocks.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image | image | image_picker | — | — |
| Image alt text | image_alt | text | — | — |
Content
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Interactive specimen matrix | Small tracked label shown above the heading |
| Heading | heading | text | Garment dossier | — |
| Text | instruction | textarea | Select a pin on the matrix to inspect the specimen and add it to your bag. | — |
image-with-text
Image with text
- Ships in:
index,page.about - Presets: Image with text
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image | image | image_picker | — | — |
| Image position (desktop) | image_position | select | left | Options: Left, Right |
| Mobile order | mobile_order | select | image-first | Options: Image first, Text first |
| Subheading | subheading | text | — | — |
| Heading | heading | text | Image with text | — |
| Text | text | richtext | <p>Pair a striking image with supporting copy.</p> | — |
| Button label | button_label | text | — | — |
| Button link | button_link | url | — | — |
| Text alignment | content_alignment | select | flex-start | Options: Left, Center |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
logo-list
Logo list
- Ships in:
index - Presets: Technical Partners
- Accepts blocks: logo
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Verified network | Small tracked label shown above the heading |
| Heading | heading | text | Technical partners | — |
| Columns on desktop | columns | range | 5 | 2–6, step 1 |
| Auto-change slides | autoplay | checkbox | true | — |
| Change every | autoplay_speed | range | 4 | 3–10 s, step 1 |
main-product
Product information
- Ships in:
product - Presets: Product information
- Only available on: product
- Accepts blocks: product-title, product-price, variant-picker, selling-plans, quantity-selector, volume-pricing, buy-buttons, product-description, trust-badges, collapsible-tab, product-share, product-text, product-separator, size-chart, low-stock, dispatch-cutoff, frequently-bought-together, delivery-date, product-reviews, gift-card-recipient, pickup-availability, custom-liquid,
@app(blocks from installed apps)
Media
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Media position | media_layout | select | left | Options: Left, Right |
| Thumbnail position | thumb_position | select | below | Options: Below, Left |
| Media width | media_width | range | 60 | 45–70 %, step 5 |
| Image ratio | gallery_ratio | select | adapt | Options: Adapt to image, Portrait, Square, Landscape |
| Enable image zoom | enable_zoom | checkbox | true | — |
| Sticky product info on desktop | enable_sticky_column | checkbox | true | — |
| Show breadcrumbs | show_breadcrumbs | checkbox | true | — |
Buy buttons
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show dynamic checkout buttons | show_dynamic_checkout | checkbox | true | Lets customers check out directly with Shop Pay, PayPal and other accelerated options |
| Show payment installments | show_payment_terms | checkbox | true | Shows Shop Pay Installments when the product and customer are eligible |
| Show tax and shipping note | show_tax_note | checkbox | true | — |
Sticky add to cart
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show sticky add to cart bar | show_sticky_atc | checkbox | true | A compact add-to-cart bar that appears once the main button scrolls out of view, on all devices |
| Position | sticky_atc_position | select | bottom | Options: Bottom, Top |
| Show image | sticky_atc_show_image | checkbox | true | — |
| Show price | sticky_atc_show_price | checkbox | true | — |
| Button label | sticky_atc_cta_label | text | Add to cart | — |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
newsletter
Newsletter
- Ships in:
index - Presets: Newsletter (Monolithic)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Restricted dispatch | Small tracked label shown above the heading |
| Heading | heading | text | Join the index | — |
| Subheading | subtext | richtext | <p>Receive notifications for limited dispatch runs.</p> | — |
| Placeholder | placeholder | text | Enter email… | — |
| Button label | button_label | text | Subscribe | — |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
page
Page
- Ships in:
page,page.about,page.authenticity,page.care,page.contact,page.materials,page.specifications
No settings.
password
Password
- Ships in:
password
No settings.
pickup-availability
Pickup availability
- Not in any default template — add it from Add section.
No settings.
predictive-search-drawer
Header search
- Not in any default template — add it from Add section.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Results per type | limit | range | 6 | 2–10, step 1 |
Search in
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Products | show_products | checkbox | true | — |
| Collections | show_collections | checkbox | false | — |
| Pages | show_pages | checkbox | false | — |
| Articles | show_articles | checkbox | false | — |
predictive-search
Predictive search
- Not in any default template — add it from Add section.
- Presets: Predictive search
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Placeholder | placeholder | text | Search products | — |
| Results per type | limit | range | 6 | 2–10, step 1 |
Search in
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Products | show_products | checkbox | true | — |
| Collections | show_collections | checkbox | false | — |
| Pages | show_pages | checkbox | false | — |
| Articles | show_articles | checkbox | false | — |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
promo-panel
Promo panel
- Ships in:
overlay-group - Presets: Promo panel
- Accepts blocks: promo-block
Visibility
Choose which pages show the promo panel. It renders store-wide from one place, so you set this once.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show on home page | show_on_home | checkbox | true | — |
| Show on product pages | show_on_product | checkbox | true | — |
| Show on collection pages | show_on_collection | checkbox | true | — |
| Show on cart page | show_on_cart | checkbox | false | — |
| Show on blog & articles | show_on_blog | checkbox | false | — |
| Show on pages | show_on_page | checkbox | false | — |
Behaviour
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Tab label | tab_label | text | Offers | — |
| Expands as | expand_style | select | sidebar | Sidebar: a panel beside the tab. Tray: a strip of small blocks along the bottom of the page. Options: Sidebar panel, Bottom tray |
| Show only when scrolling stops | show_on_scroll_stop | checkbox | true | Keeps the tab out of the way while someone is actively scrolling — it appears once they pause, then hides itself again (see “Auto-hide after” below). Turn off to keep the tab always visible |
| Auto-hide after | auto_hide_seconds | range | 6 | How long the tab stays visible (once shown) before hiding itself again — only applies while “Show only when scrolling stops” is on. 3–20 s, step 1 |
provenance-timeline
Provenance timeline
- Ships in:
index,page.about,page.authenticity,page.care - Presets: Provenance timeline
- Accepts blocks: timeline-step
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Craft provenance | Small tracked label shown above the heading |
| Heading | heading | text | Manufacturing sequence | — |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Columns on desktop | columns | range | 4 | 2–6, step 1 |
| Mobile columns | mobile_columns | select | 1 | Options: 1 column, 2 columns |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
quick-view-drawer
Quick view
- Not in any default template — add it from Add section.
No settings.
quick-view
Quick view
- Not in any default template — add it from Add section.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show dynamic checkout buttons | show_dynamic_checkout | checkbox | true | Lets customers check out directly with Shop Pay, PayPal and other accelerated options |
recently-viewed-card
Recently viewed
- Not in any default template — add it from Add section.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | image_ratio | select | portrait | Options: Portrait, Square, Landscape, Adapt to image |
| Hover effect | image_hover | select | second_image | Options: None, Show second image |
| Show colour swatches | show_swatches | checkbox | true | — |
| Show quick-view icon | show_quick_view | checkbox | true | — |
| Show add to cart button | show_add_button | checkbox | true | Adds the first available variant instantly with one click. For products with multiple options (e.g. size and color), this may not be the exact variant a customer wants — consider enabling quick view instead so they can choose first |
recently-viewed
Recently viewed
- Ships in:
product - Presets: Recently viewed
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Recently viewed | — |
| Products to show | products_count | range | 4 | 2–12, step 1 |
| Products per row | columns | range | 4 | 2–5, step 1 |
| Gap between cards | card_gap | range | 0 | 0–64 px, step 4 |
| Image ratio | image_ratio | select | portrait | Options: Portrait, Square, Landscape, Adapt to image |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
related-products
Related products
- Ships in:
product - Presets: Related products
- Only available on: product
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | You may also like | — |
| Recommendation type | intent | select | related | Complementary products are set per product in the Search & Discovery app. Options: Related products, Complementary products |
| Products to show | products_count | range | 4 | 2–10, step 1 |
| Products per row | columns | range | 4 | 2–5, step 1 |
| Gap between cards | card_gap | range | 0 | 0–64 px, step 4 |
Product card
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | image_ratio | select | portrait | Options: Portrait, Square, Landscape, Adapt to image |
| Hover effect | image_hover | select | second_image | Options: None, Show second image |
| Show colour swatches | show_swatches | checkbox | true | — |
| Show quick-view icon | show_quick_view | checkbox | false | — |
| Show add to cart button | show_add_button | checkbox | false | Adds the first available variant instantly with one click. For products with multiple options (e.g. size and color), this may not be the exact variant a customer wants — consider enabling quick view instead so they can choose first |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
reviews
Reviews
- Ships in:
index - Presets: Verified Specimen Logs
- Accepts blocks: review
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Verified specimen logs | Small tracked label shown above the heading |
| Heading | heading | text | Collector field notes | — |
| Show arrows | show_arrows | checkbox | true | — |
| Auto-change slides | autoplay | checkbox | true | — |
| Change every | autoplay_speed | range | 5 | 3–10 s, step 1 |
rich-text
Rich text
- Ships in:
index,page.about,page.authenticity,page.care,page.materials,page.specifications - Presets: Rich text
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Subheading | subheading | text | — | — |
| Heading | heading | text | Talk about your brand | — |
| Heading size | heading_size | select | m | Options: Small, Medium, Large |
| Text | text | richtext | <p>Use this text to share information about your brand with your customers.</p> | — |
| Button label | button_label | text | — | — |
| Button link | button_link | url | — | — |
| Alignment | alignment | select | center | Options: Left, Center |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
search
Search
- Ships in:
search
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show breadcrumbs | show_breadcrumbs | checkbox | true | — |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Products per row | desktop_columns | range | 4 | 2–5, step 1 |
| Mobile columns | mobile_columns | select | 2 | Options: 1 column, 2 columns |
| Gap between cards | card_gap | range | 0 | 0–64 px, step 4 |
Product card
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | image_ratio | select | portrait | Options: Portrait, Square, Landscape, Adapt to image |
| Hover effect | image_hover | select | second_image | Options: None, Show second image |
| Show colour swatches | show_swatches | checkbox | true | — |
| Colour option name | swatch_option_name | text | Color-Colour-color-colour | Separate several accepted names with hyphens, e.g. Color-Colour |
| Show compare-at price | show_compare_price | checkbox | true | — |
| Show sale badge | show_sale_badge | checkbox | true | — |
| Show quick-view icon | show_quick_view | checkbox | true | — |
| Show add to cart button | show_add_button | checkbox | false | Adds the first available variant instantly with one click. For products with multiple options (e.g. size and color), this may not be the exact variant a customer wants — consider enabling quick view instead so they can choose first |
Pagination
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Pagination style | pagination_style | select | pages | Options: Numbered pages, Load more button |
| Products per page | products_per_page | range | 24 | 8–48, step 4 |
spec-matrix
Specification matrix
- Ships in:
index,page.materials,page.specifications - Presets: Specification matrix
- Accepts blocks: Specification row (below)
- Maximum 12 blocks.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Technical specifications | Small tracked label shown above the heading |
| Heading | heading | text | Comparison matrix | — |
Comparison columns
Leave a column blank to drop it from the table.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| First column heading | row_header | text | Specification | — |
| Column 1 | column_1 | text | Specimen A | — |
| Column 2 | column_2 | text | Specimen B | — |
| Column 3 | column_3 | text | Specimen C | — |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
Block: Specification row (row)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Spec label | label | text | Primary material | — |
| Column 1 | value_1 | text | — | — |
| Column 2 | value_2 | text | — | — |
| Column 3 | value_3 | text | — | — |
split-banner
Split banner
- Ships in:
index - Presets: Split banner
Content
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Subheading | subheading | text | — | — |
| Heading | heading | text | — | — |
| Button label | button_label | text | — | — |
| Button link | button_url | url | — | — |
| Button style | button_style | select | outline | Outline reads over photography; a solid button can disappear into a dark image. Options: Outline (no background), Solid, No button |
| Image overlay | overlay_opacity | range | 40 | Darkens the image behind the text. Raise it when the photograph is busy or light. 0–80 %, step 5 |
Left image
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image | image_left | image_picker | — | — |
| Link | link_left | url | — | — |
| Alt text | alt_left | text | — | — |
Right image
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image | image_right | image_picker | — | — |
| Link | link_right | url | — | — |
| Alt text | alt_right | text | — | — |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | aspect_ratio | select | 3 / 4 | Options: Portrait, Square, Landscape |
| On mobile, show | mobile_display | select | both | Choose a single side to show as one full-width image on small screens, or keep both stacked. Options: Both, stacked, Left image only, Right image only |
tabbed-collections
Tabbed collections
- Ships in:
index - Presets: Tabbed collections
- Accepts blocks: Collection (below)
- Maximum 4 blocks.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Eyebrow label | eyebrow | text | Index catalogue | Small tracked label shown above the heading |
| Heading | heading | text | Curated archive | — |
| Products to show | products_to_show | range | 8 | 2–16, step 1 |
Layout
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Desktop layout | desktop_layout | select | grid | Options: Grid, Slider |
| Products per row | desktop_columns | range | 3 | 2–5, step 1 |
| Mobile layout | mobile_layout | select | carousel | Options: Grid, Slider |
| Mobile columns | mobile_columns | select | 1 | Options: 1 column, 2 columns |
| Gap between cards | card_gap | range | 0 | 0–64 px, step 4 |
| Show arrows | show_arrows | checkbox | true | Only shown on breakpoints set to Slider |
Product card
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image ratio | image_ratio | select | portrait | Options: Portrait, Square, Landscape, Adapt to image |
| Hover effect | image_hover | select | second_image | Options: None, Show second image |
| Show colour swatches | show_swatches | checkbox | true | — |
| Colour option name | swatch_option_name | text | Color-Colour-color-colour | Separate several accepted names with hyphens, e.g. Color-Colour |
| Show compare-at price | show_compare_price | checkbox | true | — |
| Show sale badge | show_sale_badge | checkbox | true | — |
| Show quick-view icon | show_quick_view | checkbox | false | — |
| Show add to cart button | show_add_button | checkbox | false | Adds the first available variant instantly with one click. For products with multiple options (e.g. size and color), this may not be the exact variant a customer wants — consider enabling quick view instead so they can choose first |
| Text alignment | card_text_alignment | select | left | Options: Left, Center |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |
Block: Collection (collection)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Collection | collection | collection | — | — |
| Title | title | text | — | Leave blank to use the collection title |
video
Video
- Ships in:
index - Presets: Video
Video
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Video source | video_source | select | uploaded | Options: Uploaded video, YouTube / Vimeo |
| Video | video | video | — | Shown when video_source == 'uploaded' |
| Mobile video | video_mobile | video | — | Falls back to the desktop video when not set. Shown when video_source == 'uploaded' |
| YouTube or Vimeo URL | external_video_url | video_url | — | Paste a YouTube or Vimeo video link. Add a cover image below to show a thumbnail until the visitor clicks play. Shown when video_source == 'external' |
| Cover image | cover_image | image_picker | — | Shown before the video plays |
Playback
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Autoplay | autoplay | checkbox | true | Starts muted automatically; visitors can turn on sound if it’s enabled below |
| Loop | loop | checkbox | true | — |
| Enable sound | sound | checkbox | false | Lets visitors turn the sound on. Otherwise the video always plays muted |
| Show video controls | show_controls | checkbox | false | Uses the browser’s built-in play/pause/volume controls instead of the theme’s minimal ones. Shown when video_source == 'uploaded' |
Size
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Desktop height | desktop_height | select | 720 | Options: Small, Medium, Large, Full screen |
| Mobile height | mobile_height | select | 480 | Options: Small, Medium, Large, Full screen |
| Full width | full_width | checkbox | true | — |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 60 | 0–120 px, step 4 |
| Bottom padding | padding_bottom | range | 60 | 0–120 px, step 4 |