Vellum

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

font_picker - default: "work_sans_n4"

Used for body text, navigation, and product details. A clean sans-serif keeps long text readable.

Display font

font_picker - default: "playfair_display_n4"

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

select - default: "1.25"

How much bigger each heading level is than the last. Larger ratios feel more editorial; smaller ratios feel quieter.

Base text size

range - default: 16

The size of regular body text. Headings scale from this automatically.

layout

page width

select - default: "90rem"

The widest your content column gets on large screens.

page margin

range - default: 20

Minimum space between your content and the screen edge.

Section spacing

select - default: "1.25"

Vertical breathing room between sections across the whole store. Airy suits image-led fashion stores; compact suits dense catalogs.

Grid gap

range - default: 24

Space between items in product grids and multi-column layouts.

colors

background

color - default: "#FAF9F7"

foreground

color - default: "#141414"

Accent

color - default: "#4A5D4E"

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

range - default: 2

Corner rounding for form fields like search and email boxes.

Style

Corner style

select - default: "sharp"

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

checkbox - default: true

Subtle hover and reveal transitions. Automatically disabled for visitors whose device requests reduced motion.

Design personality

Typography personality

select - default: "editorial"

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

select - default: "editorial"

How much air the whole store breathes. Editorial gives gallery spacing, Compact tightens rhythm for larger catalogs.

Media personality

select - default: "collage"

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

select - default: "editorial"

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

checkbox - default: true

Turns the announcement line on or off without deleting its text.

Text

text - default: "Complimentary shipping on orders over $150"

Link

url

Optional destination when the announcement is clicked. Leave empty for plain text.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

article

blog

Campaign break

Image

image_picker

Shown full width and loaded lazily. A photographic placeholder shows until you pick one. Ignored while a video is set.

Video

video

Shopify-hosted video. Plays muted, loops, has no controls, and replaces the image when set. Keep it short and well compressed.

Fallback collection

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

text - default: "Campaign"

Small uppercase label above the heading. Leave empty to hide.

Heading

text - default: "The season in motion"

Link label

text - default: "Explore the campaign"

Quiet text link under the heading. Only shown when the link below is set.

Link

url

Height

select - default: "natural"

Natural keeps a cinematic crop. Tall fills most of the screen.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Campaign stories

Layout

select - default: "60-40"

How the two stories share the row on desktop. Stories always stack on mobile.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Block: Story

Image

image_picker

Collection

collection

When no image is set, the story shows this collection's lead product photo.

Label

text

Small uppercase line above the heading, for example a collection name or season.

Heading

text - default: "The Automated Edit"

Text

text

Link label

text

Link

url

The whole story becomes clickable.

cart

Show order note field

checkbox - default: false

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

text - default: "Taxes and shipping calculated at checkout."

Shown under the subtotal. Leave empty to hide it.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

collection

Show breadcrumbs

checkbox - default: true

Filtering and sorting

Enable filtering

checkbox - default: true

Shows the filters you configure in the Search & Discovery app. The toolbar hides filtering automatically when no filters are set up there.

Enable sorting

checkbox - default: true

Lets shoppers reorder the collection by price, newest, and best selling.

Products per page

range - default: 24

How many products load per page before pagination.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

collections grid

grid item width

select - default: "collections--full"

How wide each collection tile is before the grid wraps to a new row.

grid gap

range - default: 10

Space between collection tiles.

Countdown

Heading

text - default: "Sale ends soon"

Subtext

text

One short supporting line under the heading. Leave empty to hide.

End date

text

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

text - default: "00:00"

24-hour format HH:MM, for example 18:30. Leave as 00:00 to end at the start of the end date.

Button label

text

Button link

url

After expiry

select - default: "hide"

What shoppers see once the countdown reaches zero.

Expired message

text - default: "This offer has ended."

Shown in place of the timer after expiry when After expiry is set to Show expired message.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section, e.g. .countdown__digit { letter-spacing: 0.05em; }. Survives theme updates.

Complete the look

Heading

text - default: "Complete the look"

Products to pair

product_list

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

checkbox - default: true

When you have not curated products, shows other products from this product's first collection.

Micro label

text - default: "Wear it with"

Small uppercase label above the heading, in the editorial opener style. Leave empty to hide.

Campaign image

image_picker

Shown at 4:5 beside the paired products. A photographic placeholder appears until you pick an image.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

custom section

background

image_picker

Discovery rail

Micro label

text - default: "02 / Discover"

Small uppercase label above the heading, e.g. a campaign index like 02 / Discover.

Heading

text - default: "Discovery"

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Block: Collection row

Collection

collection

Four products from this collection appear in the row. Blocks whose collection is empty are skipped.

Index label

text

Shown in the numbered index, e.g. New arrivals. Defaults to the collection title.

Editorial hero

Image

image_picker

The campaign photo. It loads first, so use a well compressed image. A photographic placeholder shows until you pick one.

Campaign index

text - default: "01 / Autumn 26"

Small uppercase label above the title, like a magazine issue number. Leave empty to hide.

Title

textarea - default: "The Autumn\nEdit"

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

text - default: "Worn in, not worn out"

Only shown when the Title above is empty. Kept so older stores upgrading from v1 keep their saved heading.

Subtext

text - default: "Season pieces cut to last, in cloth that softens with wear."

Keep it under 20 words.

Button label

text - default: "Shop the collection"

Button link

url

Secondary link label

text - default: "Explore the lookbook"

Quiet text link shown beside the button. Only shown when the secondary link below is set.

Secondary link

url

Show secondary image

checkbox - default: true

Layers a smaller portrait crop over the main image on desktop. Hidden on mobile to keep the opening clean.

Secondary image

image_picker

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

collection

Optional. When no images are set, product photography from this collection fills the hero crop instead of a placeholder.

Height

select - default: "natural"

Natural keeps an editorial crop. Large fills most of the screen.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Editorial quote

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Block: Quote

Quote

textarea - default: "The rare kind of clothes you plan a week around."

Renders at display size. Keep it to three lines or fewer, about 12 words.

Name

text - default: "Nour A."

Source

text - default: "Verified buyer"

Publication or context, for example Verified buyer or Monocle.

Editorial statement

Statement

textarea - default: "MADE TO BE\nWORN FOR YEARS."

Renders at the largest display size. Each line in this box becomes its own row. Two or three short uppercase lines work best.

Text

textarea - default: "No season resets, no filler. Cut, cloth, and care chosen so each year adds to the last."

Keep it under about 25 words so the statement stays the focus.

Link label

text - default: "Read our approach"

Quiet text link under the paragraph. Only shown when the link below is set.

Link

url

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Editorial text

Heading

text - default: "Made to be worn for years"

Text

richtext - default: "<p>Tell the story behind a collection, a fabric, or your atelier. This section uses your display font for the heading and keeps the measure readable.</p>"

Button label

text

Button link

url

Alignment

select - default: "start"

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section, e.g. .editorial-text__heading { letter-spacing: 0.05em; }. Survives theme updates.

footer

menu

link_list

show payment icons

checkbox - default: true

Shows the payment method icons your store accepts.

Newsletter

Heading

text - default: "Stay in the loop"

Text

text - default: "New collections, editorials, and early access. No noise."

Link columns

First column menu

link_list - default: "footer"

Menu shown in the first footer column.

Second column menu

link_list

Menu shown in the second footer column.

Third column menu

link_list

Menu shown in the third footer column.

Social

Instagram URL

url

TikTok URL

url

Pinterest URL

url

YouTube URL

url

Region

Show country and language selectors

checkbox - default: true

Shown only when your store has more than one market country or published language.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

header

menu

link_list

customer account menu

link_list - default: "customer-account-main-menu"

Mega menu

Menu panel image

image_picker

Optional promotional image shown at the right of open menu panels

Menu panel image link

url

Destination when the menu panel image is clicked. Leave empty for a plain image.

Sticky header

Transparent over home page hero

checkbox - default: false

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

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Image with story

Image

image_picker

Second image

image_picker

Optional. A smaller image layered over the first for an editorial feel. Stacks below it on mobile.

Heading

text - default: "Cut from cloth that lasts"

Story

richtext - default: "<p>Tell the story behind the piece: the mill, the maker, the reason it exists. Two or three short paragraphs read best beside the image.</p>"

Link label

text

Link

url

Image position

select - default: "image_left"

Which side the images sit on at desktop widths. Mobile always stacks images above the story.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Journal

Blog

blog

The three most recent articles from this blog appear here.

Fallback collection

collection

Optional. Articles without a featured image borrow the first product image from this collection instead of showing a placeholder.

Label

text - default: "Journal"

Small uppercase line above the heading.

Heading

text - default: "Field notes"

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Lookbook

Heading

text - default: "The Edit"

Intro text

richtext

Micro label

text - default: "Lookbook"

Small uppercase label above the heading, in the editorial opener style. Leave empty to hide.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Block: Look

Look image

image_picker

Shown at 4:5. A photographic placeholder appears until you pick an image.

Heading

text

Caption

text

Products in this look

product_list

Products shoppers can buy from this look: hotspot cards on desktop, a swipeable product rail on mobile.

Fallback collection

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

range - default: 28

Horizontal position of the first product's hotspot, from the left edge of the photo.

Product 1 down

range - default: 32

Vertical position of the first product's hotspot, from the top edge of the photo.

Product 2 across

range - default: 62

Horizontal position of the second product's hotspot, from the left edge of the photo.

Product 2 down

range - default: 50

Vertical position of the second product's hotspot, from the top edge of the photo.

Product 3 across

range - default: 44

Horizontal position of the third product's hotspot, from the left edge of the photo.

Product 3 down

range - default: 74

Vertical position of the third product's hotspot, from the top edge of the photo.

Materials story

Image

image_picker

A close-up texture or fabric detail works best. A photographic placeholder shows until you pick one.

Fallback collection

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

text - default: "Materials"

Small uppercase line above the heading.

Heading

text - default: "Cloth that earns its keep"

Lede

textarea - default: "We buy fabric the way you buy clothes: rarely, carefully, and to last. Every bolt is milled by partners we have worked with for years."

One or two sentences set larger than body text, like a pull quote.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Block: List item

Title

text - default: "Two-fold organic cotton"

Text

text - default: "Woven tight, washed soft, made to age well."

Keep it to one line.

Newsletter

Heading

textarea - default: "STAY\nIN THE\nLOOP."

Each line renders as its own row at the largest display size. Keep to three short lines.

Text

text - default: "New collections, fabric stories, and early access. About one email a month."

Success message

text - default: "Thank you. You are on the list."

Shown after a successful signup.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

page

password

Product

Show breadcrumbs

checkbox - default: true

Image variant swatches

checkbox - default: true

Shows each color as a small photo of that variant instead of a text button. Uses each variant's featured image.

Swatch option name

text - default: "Color"

The product option rendered as image swatches. Matches the option name in your product admin, usually Color.

Show only the selected variant's images

checkbox - default: true

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

checkbox - default: true

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

checkbox - default: true

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

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Promo tiles

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

Block: Tile

Image

image_picker

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 - default: "The new edit"

Text

text

Link label

text

Shown as underlined text on the tile. Only appears when a link is set.

Link

url

When set, the whole tile becomes clickable.

Tile size

select - default: "normal"

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

text - default: "Recently viewed"

Products to show

range - default: 4

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

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.

search

Shop the edit

Micro label

text - default: "01 / The edit"

Small uppercase label above the heading, e.g. a campaign index like 01 / Autumn 26.

Heading

text - default: "Shop the edit"

Collection

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

range - default: 6

Number of product cards beside the campaign tile. Six fills the desktop composition; fewer keeps it to a single row.

Campaign tile

Campaign image

image_picker

Tall editorial crop (4:5 works best). A photographic placeholder shows until you pick one.

Campaign micro label

text - default: "Campaign"

Small uppercase label on the campaign tile.

Campaign title

text - default: "The season, edited"

Campaign link label

text - default: "Shop the collection"

Short call to action shown on the campaign tile. The whole tile links to the collection.

Advanced customization

Custom Liquid

liquid

Rendered at the end of this section. Survives theme updates because it is stored as a setting, not a code edit.

Custom CSS

textarea

Plain CSS applied only to this section. Survives theme updates.