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.

Sections

404

article

blog

cart

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.

Cross-sell

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.

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

Editorial hero

Image

image_picker

Shown full width. Loads first, so use a well compressed photo.

Heading

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

Keep it to about 5 words. It renders at display size.

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

Height

select - default: "natural"

Natural keeps a wide 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 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.

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.

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.

Lookbook

Heading

text - default: "The Edit"

Intro text

richtext

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. Without an image the look renders its products in a bordered panel.

Heading

text

Caption

text

Products in this look

product_list

Products shown beside this look so shoppers can buy what they see.

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