Store-wide controls

Set the foundation.

Open Theme settings in the theme editor. These values are shared across templates; individual sections choose their own color scheme and content.

Piéra uses Atelier Editorial; Émeraude uses Émeraude. Selecting Design style alone does not install a preset’s page layout. Understand presets and layouts.

Typography

Headings

Heading font

type_heading_font

Schema default: work_sans_n6. Presets can override it.

Sets the heading font across the theme.

Recommended: Use a legible family and limit font variations. Check long product names and accented characters.

Heading scale

heading_scale

Schema default: 105%. Presets can override it.

Range: 80–140%; step 5.

Adjusts heading scale within the range shown.

Recommended: Start at 105%; check the smallest and widest layouts before increasing it.

Heading letter spacing

heading_letter_spacing

Schema default: -2%. Presets can override it.

Range: -4–8%; step 1.

Adjusts heading letter spacing within the range shown.

Recommended: Start at -2%; check the smallest and widest layouts before increasing it.

Body text

Body font

type_body_font

Schema default: work_sans_n4. Presets can override it.

Sets the body font across the theme.

Recommended: Use a legible family and limit font variations. Check long product names and accented characters.

Body scale

body_scale

Schema default: 100%. Presets can override it.

Range: 90–120%; step 5.

Adjusts body scale within the range shown.

Recommended: Start at 100%; check the smallest and widest layouts before increasing it.

Design style

Design style

design_style

Schema default: Classic. Presets can override it.

Choices: Classic · Atelier Editorial · Émeraude.

Selects the shared design language across templates, not the full preset content arrangement.

Editor note: Atelier Editorial applies a shared editorial language to every page: display typography, header, buttons, links and spacing. Uses your fonts and section color schemes. Émeraude builds on the same editorial language with a dark emerald, black and gold palette for watches and jewellery. Classic keeps the existing design.

Recommended: Choose Atelier Editorial for Piéra or Émeraude for watches. Classic is a compatibility option, not an additional release preset.

Home page art direction

Modern jewel editorial

editorial_homepage

Schema default: false. Presets can override it.

Applies the coordinated Modern jewel editorial home composition.

Editor note: A coordinated home page layout with compact service points and refined image proportions. Other templates retain their existing design. Uses your section color schemes and fonts.

Recommended: Keep the installed preset value initially; preview home-page spacing before changing it.

Layout

Page width

max_page_width

Schema default: Wide. Presets can override it.

Choices: Editorial · Wide · Immersive.

Chooses the page width behavior or layout from the listed options.

Recommended: Start with the preset choice. Compare the available modes in desktop and mobile previews.

Minimum page margin

min_page_margin

Schema default: 24px. Presets can override it.

Range: 16–80px; step 4.

Adjusts minimum page margin within the range shown.

Recommended: Start at 24px; check the smallest and widest layouts before increasing it.

Section spacing

section_spacing

Schema default: 96px. Presets can override it.

Range: 40–160px; step 8.

Adjusts section spacing within the range shown.

Recommended: Start at 96px; check the smallest and widest layouts before increasing it.

Colors

color_schemes

color_schemes

No schema default; the installed preset may supply a value.

Defines the reusable color schemes used throughout sections.

Recommended: Edit the nested colors below and verify every section using the changed scheme.

Background

background

Schema default: #F4F0E8. Presets can override it.

Sets background for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Background gradient

background_gradient

No schema default; the installed preset may supply a value.

Sets background gradient for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Text

text

Schema default: #181612. Presets can override it.

Sets text for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Headings

heading

Schema default: #181612. Presets can override it.

Sets headings for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Accent

accent

Schema default: #7A302E. Presets can override it.

Sets accent for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Primary button

button

Schema default: #181612. Presets can override it.

Sets primary button for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Primary button label

button_label

Schema default: #F8F5EF. Presets can override it.

Sets primary button label for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Secondary button label

secondary_button_label

Schema default: #181612. Presets can override it.

Sets secondary button label for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Borders

border

Schema default: #8A8175. Presets can override it.

Sets borders for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Shadows

shadow

Schema default: #181612. Presets can override it.

Sets shadows for this color treatment.

Recommended: Use your brand palette and verify foreground/background contrast, including buttons and focus outlines.

Default color scheme

default_color_scheme

Schema default: scheme-1. Presets can override it.

Applies a coordinated set of background, text, accent and button colors.

Recommended: Start with the preset scheme. Check contrast after changing colors or photography.

Style

Corner style

corner_radius

Schema default: Refined. Presets can override it.

Choices: Architectural · Refined · Soft · Playful.

Chooses the corner style behavior or layout from the listed options.

Recommended: Start with the preset choice. Compare the available modes in desktop and mobile previews.

Button height

button_height

Schema default: 52px. Presets can override it.

Range: 44–64px; step 2.

Adjusts button height within the range shown.

Recommended: Start at 52px; check the smallest and widest layouts before increasing it.

Use uppercase button labels

uppercase_buttons

Schema default: true. Presets can override it.

Turns “Use uppercase button labels” on or off.

Recommended: Start with the preset choice. Enable only when the relevant content or store feature is configured, then preview the result.

Motion

Enable interface motion

enable_motion

Schema default: true. Presets can override it.

Controls theme-wide interface motion.

Recommended: Turn off for a deliberately static storefront. Check browser reduced-motion settings as well.

Motion speed

motion_scale

Schema default: 100%. Presets can override it.

Range: 70–130%; step 10.

Conditional in the editor: {{ settings.enable_motion }}

Scales supported interface animation durations; higher values take longer. It does not set the slideshow interval.

Recommended: Start at 100%. Preview 70% for quicker transitions or 130% for slower ones; some effects have independent timing.

Brand assets

Favicon

favicon

No schema default; the installed preset may supply a value.

Supplies favicon for this section or block.

Recommended: Use the image dimensions on this page; choose a focal point where supported and inspect the actual crop. Leave optional images blank when they add no value.

Navigation

Default shop collection

fallback_collection

No schema default; the installed preset may supply a value.

Connects a Shopify collection as the content source.

Editor note: Used by built-in shop links when no menu or section-specific link is selected.

Recommended: Select the real store resource. Confirm it is available to the storefront; a theme ZIP does not create it.

Commerce

Open cart in a drawer

enable_cart_drawer

Schema default: true. Presets can override it.

Turns “Open cart in a drawer” on or off.

Recommended: Start with the preset choice. Enable only when the relevant content or store feature is configured, then preview the result.

Enable quick buy on product cards

enable_quick_buy

Schema default: true. Presets can override it.

Turns “Enable quick buy on product cards” on or off.

Recommended: Start with the preset choice. Enable only when the relevant content or store feature is configured, then preview the result.

Enable quick view for products with options

enable_quick_view

Schema default: true. Presets can override it.

Conditional in the editor: {{ settings.enable_quick_buy }}

Turns “Enable quick view for products with options” on or off.

Recommended: Start with the preset choice. Enable only when the relevant content or store feature is configured, then preview the result.

Show custom product badges

enable_custom_badges

Schema default: true. Presets can override it.

Turns “Show custom product badges” on or off.

Editor note: Uses the custom.badge product metafield when it contains text.

Recommended: Start with the preset choice. Enable only when the relevant content or store feature is configured, then preview the result.

Social media

Instagram

social_instagram_link

No schema default; the installed preset may supply a value.

Sets the destination for instagram.

Recommended: Use the resource picker for internal links. Preview the destination and provide matching link text.

TikTok

social_tiktok_link

No schema default; the installed preset may supply a value.

Sets the destination for tiktok.

Recommended: Use the resource picker for internal links. Preview the destination and provide matching link text.

Pinterest

social_pinterest_link

No schema default; the installed preset may supply a value.

Sets the destination for pinterest.

Recommended: Use the resource picker for internal links. Preview the destination and provide matching link text.

Facebook

social_facebook_link

No schema default; the installed preset may supply a value.

Sets the destination for facebook.

Recommended: Use the resource picker for internal links. Preview the destination and provide matching link text.

YouTube

social_youtube_link

No schema default; the installed preset may supply a value.

Sets the destination for youtube.

Recommended: Use the resource picker for internal links. Preview the destination and provide matching link text.

X

social_x_link

No schema default; the installed preset may supply a value.

Sets the destination for x.

Recommended: Use the resource picker for internal links. Preview the destination and provide matching link text.

Animation guide · Launch checks