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.
Design personality
Typography personality
Editorial pairs your serif display font with generous scale. Contemporary sets headlines in your primary font with tighter tracking. Minimal quiets the scale for product-led stores.
Visual density
How much air the whole store breathes. Editorial gives gallery spacing, Compact tightens rhythm for larger catalogs.
Media personality
Clean keeps imagery in tidy frames. Collage lets secondary images overlap for a layered editorial feel. Immersive biases sections toward full-bleed imagery.
Product presentation
Gallery uses tall 3:4 imagery with quiet details. Editorial uses 4:5 with fuller information. Compact uses square images and denser rows for larger catalogs.
Sections
404
Announcement bar
Show announcement
Turns the announcement line on or off without deleting its text.
Text
Link
Optional destination when the announcement is clicked. Leave empty for plain 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.
article
blog
Campaign break
Image
Shown full width and loaded lazily. A photographic placeholder shows until you pick one. Ignored while a video is set.
Video
Shopify-hosted video. Plays muted, loops, has no controls, and replaces the image when set. Keep it short and well compressed.
Fallback collection
Optional. When no image or video is set, the first product image from this collection is used, so the section never renders an empty block.
Label
Small uppercase label above the heading. Leave empty to hide.
Heading
Link label
Quiet text link under the heading. Only shown when the link below is set.
Link
Height
Natural keeps a cinematic crop. Tall 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.
Campaign stories
Layout
How the two stories share the row on desktop. Stories always stack on mobile.
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: Story
Image
Collection
When no image is set, the story shows this collection's lead product photo.
Label
Small uppercase line above the heading, for example a collection name or season.
Heading
Text
Link label
Link
The whole story becomes clickable.
cart
Show order note field
Adds an optional note field shoppers can send with their order. The note is saved when the cart is updated and shows on the order in your admin.
Taxes and shipping note
Shown under the subtotal. Leave empty to hide it.
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.
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.
Complete the look
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.
Micro label
Small uppercase label above the heading, in the editorial opener style. Leave empty to hide.
Campaign image
Shown at 4:5 beside the paired products. A photographic placeholder appears until you pick an 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.
custom section
background
Discovery rail
Micro label
Small uppercase label above the heading, e.g. a campaign index like 02 / Discover.
Heading
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: Collection row
Collection
Four products from this collection appear in the row. Blocks whose collection is empty are skipped.
Index label
Shown in the numbered index, e.g. New arrivals. Defaults to the collection title.
Editorial hero
Image
The campaign photo. It loads first, so use a well compressed image. A photographic placeholder shows until you pick one.
Campaign index
Small uppercase label above the title, like a magazine issue number. Leave empty to hide.
Title
Renders at the largest display size. Each line in this box becomes its own row. When empty, the Heading setting below is used instead.
Heading
Only shown when the Title above is empty. Kept so older stores upgrading from v1 keep their saved heading.
Subtext
Keep it under 20 words.
Button label
Button link
Secondary link label
Quiet text link shown beside the button. Only shown when the secondary link below is set.
Secondary link
Show secondary image
Layers a smaller portrait crop over the main image on desktop. Hidden on mobile to keep the opening clean.
Secondary image
Portrait crop layered over the main image, like a product detail or a second campaign frame. A placeholder shows until you pick one.
Fallback collection
Optional. When no images are set, product photography from this collection fills the hero crop instead of a placeholder.
Height
Natural keeps an 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 quote
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: Quote
Quote
Renders at display size. Keep it to three lines or fewer, about 12 words.
Name
Source
Publication or context, for example Verified buyer or Monocle.
Editorial statement
Statement
Renders at the largest display size. Each line in this box becomes its own row. Two or three short uppercase lines work best.
Text
Keep it under about 25 words so the statement stays the focus.
Link label
Quiet text link under the paragraph. Only shown when the link below is set.
Link
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.
Newsletter
Heading
Text
Link columns
First column menu
Menu shown in the first footer column.
Second column menu
Menu shown in the second footer column.
Third column menu
Menu shown in the third footer column.
Social
Instagram URL
TikTok URL
Pinterest URL
YouTube URL
Region
Show country and language selectors
Shown only when your store has more than one market country or published language.
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.
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.
Sticky header
Transparent over home page hero
Starts the header with no background on the home page and fades in a solid background once the visitor scrolls. Works best with a full width hero at the top of the page.
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.
Journal
Blog
The three most recent articles from this blog appear here.
Fallback collection
Optional. Articles without a featured image borrow the first product image from this collection instead of showing a placeholder.
Label
Small uppercase line above the heading.
Heading
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
Micro label
Small uppercase label above the heading, in the editorial opener style. Leave empty to hide.
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. A photographic placeholder appears until you pick an image.
Heading
Caption
Products in this look
Products shoppers can buy from this look: hotspot cards on desktop, a swipeable product rail on mobile.
Fallback collection
Optional. When no image is set, the first product image from this collection is used so the look never renders an empty block.
Hotspots
Product 1 across
Horizontal position of the first product's hotspot, from the left edge of the photo.
Product 1 down
Vertical position of the first product's hotspot, from the top edge of the photo.
Product 2 across
Horizontal position of the second product's hotspot, from the left edge of the photo.
Product 2 down
Vertical position of the second product's hotspot, from the top edge of the photo.
Product 3 across
Horizontal position of the third product's hotspot, from the left edge of the photo.
Product 3 down
Vertical position of the third product's hotspot, from the top edge of the photo.
Materials story
Image
A close-up texture or fabric detail works best. A photographic placeholder shows until you pick one.
Fallback collection
Optional. When no image is set, the first product image from this collection is used, so the section never renders an empty block.
Label
Small uppercase line above the heading.
Heading
Lede
One or two sentences set larger than body text, like a pull quote.
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: List item
Title
Text
Keep it to one line.
Newsletter
Heading
Each line renders as its own row at the largest display size. Keep to three short lines.
Text
Success message
Shown after a successful signup.
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.
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.
search
Shop the edit
Micro label
Small uppercase label above the heading, e.g. a campaign index like 01 / Autumn 26.
Heading
Collection
Product cards come from this collection and the campaign tile links to it. Shoppers only see this section once the collection has products.
Products to show
Number of product cards beside the campaign tile. Six fills the desktop composition; fewer keeps it to a single row.
Campaign tile
Campaign image
Tall editorial crop (4:5 works best). A photographic placeholder shows until you pick one.
Campaign micro label
Small uppercase label on the campaign tile.
Campaign title
Campaign link label
Short call to action shown on the campaign tile. The whole tile links to the 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.