Every setting
Generated from the theme's own configuration on every docs build, so nothing here can be out of date.
Theme settings
typography
primary
Used for body text, navigation, and product details. A clean sans-serif keeps long text readable.
Display font
Used for large headlines and section titles only. Pairs an editorial serif with your body font; pick the same font as your primary font for a uniform look.
Heading scale
How much bigger each heading level is than the last. Larger ratios feel more editorial; smaller ratios feel quieter.
Base text size
The size of regular body text. Headings scale from this automatically.
layout
page width
The widest your content column gets on large screens.
page margin
Minimum space between your content and the screen edge.
Section spacing
Vertical breathing room between sections across the whole store. Airy suits image-led fashion stores; compact suits dense catalogs.
Grid gap
Space between items in product grids and multi-column layouts.
colors
background
foreground
Accent
Used sparingly: primary buttons, links, and highlights. One accent across the whole store keeps the brand coherent: borders and muted text are derived automatically from your background and text colors.
input corner radius
Corner rounding for form fields like search and email boxes.
Style
Corner style
One corner system for the whole store: buttons, cards, and media all follow it. Sharp reads editorial, Soft reads friendly, Pill rounds buttons fully.
Enable animations
Subtle hover and reveal transitions. Automatically disabled for visitors whose device requests reduced motion.
Sections
404
article
blog
cart
collection
Show breadcrumbs
Filtering and sorting
Enable filtering
Shows the filters you configure in the Search & Discovery app. The toolbar hides filtering automatically when no filters are set up there.
Enable sorting
Lets shoppers reorder the collection by price, newest, and best selling.
Products per page
How many products load per page before pagination.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
collections grid
grid item width
How wide each collection tile is before the grid wraps to a new row.
grid gap
Space between collection tiles.
Countdown
Heading
Subtext
One short supporting line under the heading. Leave empty to hide.
End date
Format YYYY-MM-DD, for example 2026-12-31. The countdown runs on the shopper's device clock, so the end moment is interpreted in each shopper's timezone, not your store timezone. If empty or invalid, the section stays hidden for shoppers.
End time
24-hour format HH:MM, for example 18:30. Leave as 00:00 to end at the start of the end date.
Button label
Button link
After expiry
What shoppers see once the countdown reaches zero.
Expired message
Shown in place of the timer after expiry when After expiry is set to Show expired message.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section, e.g. .countdown__digit { letter-spacing: 0.05em; }. Survives theme updates.
Cross-sell
Heading
Products to pair
Shown on the product page to sell the look. Pick up to 4 products that pair with the one being viewed.
Fill with collection products
When you have not curated products, shows other products from this product's first collection.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
custom section
background
Editorial hero
Image
Shown full width. Loads first, so use a well compressed photo.
Heading
Keep it to about 5 words. It renders at display size.
Subtext
Keep it under 20 words.
Button label
Button link
Height
Natural keeps a wide editorial crop. Large fills most of the screen.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
Editorial text
Heading
Text
Button label
Button link
Alignment
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section, e.g. .editorial-text__heading { letter-spacing: 0.05em; }. Survives theme updates.
footer
menu
show payment icons
Shows the payment method icons your store accepts.
header
menu
customer account menu
Mega menu
Menu panel image
Optional promotional image shown at the right of open menu panels
Menu panel image link
Destination when the menu panel image is clicked. Leave empty for a plain image.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
Image with story
Image
Second image
Optional. A smaller image layered over the first for an editorial feel. Stacks below it on mobile.
Heading
Story
Link label
Link
Image position
Which side the images sit on at desktop widths. Mobile always stacks images above the story.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
Lookbook
Heading
Intro text
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
Block: Look
Look image
Shown at 4:5. Without an image the look renders its products in a bordered panel.
Heading
Caption
Products in this look
Products shown beside this look so shoppers can buy what they see.
page
password
Product
Show breadcrumbs
Image variant swatches
Shows each color as a small photo of that variant instead of a text button. Uses each variant's featured image.
Swatch option name
The product option rendered as image swatches. Matches the option name in your product admin, usually Color.
Show only the selected variant's images
Hides gallery images that belong to other variants, so customers only see the color they picked. Images not linked to any variant always stay visible.
Sticky add to cart
Keeps a compact add-to-cart bar at the bottom of the screen once the main button scrolls out of view.
Back-in-stock signup
Shows an email capture on sold-out variants. Requests arrive as contact form submissions with the product in the subject line.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
Promo tiles
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.
Block: Tile
Image
Shown at 4:5 on normal tiles and 16:9 on wide tiles. Without an image the tile renders as a bordered panel.
Heading
Text
Link label
Shown as underlined text on the tile. Only appears when a link is set.
Link
When set, the whole tile becomes clickable.
Tile size
On desktop, normal tiles sit two per row; a wide tile spans the full row. All tiles stack in one column on mobile.
Recently viewed
Heading
Products to show
Maximum number of products shown. Shoppers only see products they have already visited in this browser, so fewer may appear. The section stays hidden until there is at least one product to show.
Advanced customization
Custom Liquid
Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.
Custom CSS
Plain CSS applied only to this section. Survives theme updates.