Skip to main content
This page is a complete transcription of config/settings_schema.json. Every group, every setting, every default — in the same order as the file. Use this as a quick lookup; the live Theme Editor will always be the canonical place to make edits.

​
Theme info

The first object in the schema is informational metadata, not a setting group. It tells Shopify and the Theme Editor what to display as the theme’s identity.
Logo (default / navy variant).
​
logo_white
image_picker
Logo (light variant for dark backgrounds). Used on the transparent home-hero header and any dark-band section.
​
logo_width
range
default:"140"
Logo width on desktop. Min 60, max 320, step 10, unit px.
​
favicon
image_picker
Square PNG or SVG. Will be cropped to a 32×32 square.

​
Colors

​
Brand palette

​
color_primary
color
default:"#002F5B"
Primary (ink) — used for body text, primary buttons, hairlines.
​
color_secondary
color
default:"#F6F4EF"
Secondary (paper) — the default page background.
​
color_accent
color
default:"#C39738"
Accent — used sparingly for editorial flourishes.
​
color_muted
color
default:"#565E6B"
Muted text — secondary copy, captions, tiny-num annotations.

​
Scheme 1 — Default (page)

​
scheme_1_bg
color
default:"#F6F4EF"
​
scheme_1_fg
color
default:"#002F5B"

​
Scheme 2 — Inverse (navy)

​
scheme_2_bg
color
default:"#002F5B"
​
scheme_2_fg
color
default:"#F6F4EF"

​
Scheme 3 — Soft (warm cream)

​
scheme_3_bg
color
default:"#EFE9DC"
​
scheme_3_fg
color
default:"#0A0F18"

​
Scheme 4 — Deep (charcoal)

​
scheme_4_bg
color
default:"#0A0F18"
​
scheme_4_fg
color
default:"#F6F4EF"

​
Functional

​
color_success
color
default:"#2E7D32"
​
color_error
color
default:"#B00020"
​
color_rule
color
default:"#E5E2DA"
Rule / hairline color. Used for dividers and faint borders.

​
Typography

​
Body

​
font_body
font_picker
default:"assistant_n4"
Body font.
​
font_body_scale
range
default:"100"
Body size as a percentage. Min 90, max 130, step 5, unit %.

​
Headings

​
font_heading
font_picker
default:"playfair_display_n4"
Heading font.
​
font_heading_scale
range
default:"110"
Heading size as a percentage. Min 90, max 160, step 5, unit %.

​
Accent / script

​
font_accent
font_picker
default:"playfair_display_i4"
Accent font (italic / script). Used for the editorial accents — script headings, color labels, signatures.

​
Buttons

​
button_style
select
default:"solid"
Default button style. Options:
  • solid — solid background, contrasting label
  • outline — transparent background, ink border
  • underline — text-only with an underline
​
button_corner_radius
select
default:"0"
Corner radius. Options:
  • 0 — Sharp
  • 2 — 2 px
  • 4 — 4 px
  • 8 — 8 px
  • 999 — Pill
​
button_letterspacing
select
default:"extra"
Letter-spacing. Options:
  • normal — 0.02em
  • wide — 0.12em
  • extra — 0.22em (editorial)

​
Layout

​
container_width
select
default:"1280"
Container width. Options:
  • full — 100%
  • 1440 — 1440 px
  • 1280 — 1280 px (default)
  • 1024 — 1024 px
​
section_spacing
select
default:"comfortable"
Section spacing. Options:
  • compact — 48 px section padding
  • comfortable — 80 px (default)
  • spacious — 120 px
​
rule_style
select
default:"thin"
Rule / divider style. Options:
  • thin — 1 px
  • medium — 2 px
  • double — 3 px

​
Cards

​
card_image_ratio
select
default:"portrait"
Product card image ratio. Options:
  • portrait — 4:5
  • square — 1:1
  • landscape — 4:3
​
card_text_alignment
select
default:"left"
Product card text alignment. Options:
  • left
  • center
​
card_show_quickview
checkbox
default:"true"
Show quick-view hover button on product cards.
​
card_show_wishlist
checkbox
default:"true"
Show wishlist hover button on product cards.
​
card_show_vendor
checkbox
default:"false"
Show product vendor beneath the title.

​
Cart

​
cart_type
select
default:"drawer"
Cart type. Options:
  • drawer — slides in from the side
  • page — full cart page
  • notification — popup on add
​
cart_show_notes
checkbox
default:"true"
Show order notes field in the cart.
​
cart_show_discount_codes
checkbox
default:"true"
Show discount code field.

​
Animation

​
animations_reveal
checkbox
default:"true"
Reveal animations on scroll.
​
animations_hover
checkbox
default:"true"
Image zoom on hover.
​
animations_blur
checkbox
default:"true"
Image blur-to-clear on scroll.

​
Editorial premium effects

​
show_cursor
checkbox
default:"true"
Custom cursor — uses the data-cursor attribute on interactive elements.
​
show_grain
checkbox
default:"true"
Film grain overlay across the viewport.
​
show_intro_loader
checkbox
default:"true"
Intro loader — the navy curtain that rises on first visit.
​
click_sounds
checkbox
default:"true"
Click sounds on primary CTAs.
​
show_back_to_top
checkbox
default:"true"
Show a floating back-to-top button after the visitor scrolls past the first viewport.

​
Tab title recall

When a visitor switches to another tab, the storefront’s browser-tab title rotates through merchant-editable messages. See Tab title recall for the full walkthrough.
​
tab_recall_enable
checkbox
default:"true"
Master toggle.
​
tab_recall_delay
range
default:"1s"
Delay before the first message swap.
​
tab_recall_interval
range
default:"2s"
Interval between message rotations.
​
tab_recall_message_1
text
default:"← Don't leave! Come back"
First message in the rotation.
​
tab_recall_message_2
text
default:"← Selling fast · only a few left"
Second message.
​
tab_recall_message_3
text
default:"← Hurry · stock running low"
Third message.

​
Quick view

Strings shown by the quick-view modal during the fetch + on failure. See Quick view modal.
​
quickview_loading_text
text
default:"Loading…"
Body content while the product fetch is in flight.
​
quickview_error_text
text
default:"Sorry — could not load this piece."
Body content if the fetch fails.
​
quickview_heading_aria
text
default:"Product details"
Modal accessible label (announced by screen readers).

​
Size finder

Cross-brand size recommendation matrix on the PDP. See Size finder for the full walkthrough.
​
size_finder_heading
text
default:"Recommend my size"
Eyebrow above the size finder panel.
​
size_finder_open_label
text
default:"Find my size →"
Toggle label when the panel is closed.
​
size_finder_close_label
text
default:"Close size finder"
Toggle label when the panel is open.
​
size_finder_brand_matrix
textarea
One brand per line — Brand Name | XS=XS, S=S, M=M, L=L, XL=XL, XXL=XXL. Clear all lines to hide the brand selector entirely.

​
Age verifier

Splash gate for liquor / age-restricted brands. Off by default. See Age verifier for setup.
​
age_verifier_enable
checkbox
default:"false"
Master toggle. Off by default — turn on only if your products require an age check.
​
age_verifier_min_age
range
default:"21"
Minimum age the visitor must meet. Range 13–30.
​
age_verifier_eyebrow
text
default:"A small question"
Eyebrow above the headline.
​
age_verifier_headline
text
default:"Are you of legal age?"
Main question.
​
age_verifier_body
richtext
Body paragraph with the legal disclaimer.
​
age_verifier_button_label
text
default:"Yes — enter site"
Confirm CTA label.
​
age_verifier_decline_label
text
default:"I am under age"
Decline button label.
​
age_verifier_decline_message
text
Shown after a failed verification or a decline.

​
Social media

​
social_instagram_link
text
Instagram URL.
​
social_facebook_link
text
Facebook URL.
​
social_pinterest_link
text
Pinterest URL.
​
social_tiktok_link
text
TikTok URL.
​
social_youtube_link
text
YouTube URL.
​
social_x_link
text
X / Twitter URL.
​
social_linkedin_link
text
LinkedIn URL.
​
social_threads_link
text
Threads URL.

​
Currency

​
show_currency_codes
checkbox
default:"false"
Show currency codes (e.g. USD next to price). Adds the ISO code next to formatted prices. Helps multi-market shoppers identify the currency at a glance.
​
search_predictive
checkbox
default:"true"
Show predictive search dropdown.
​
search_show_collections
checkbox
default:"true"
Include collections in predictive results.
​
search_show_articles
checkbox
default:"false"
Include articles in predictive results.
​
search_show_pages
checkbox
default:"false"
Include pages in predictive results.
​
search_empty_text
text
default:"No pieces match — try a different term."
Shown in the predictive-search right pane when a query returns zero products.

​
Collection pagination

Controls how the collection page renders product overflow. See Collection pagination modes for the walkthrough.
​
collection_pagination_mode
select
default:"pagination"
Options: pagination (numbered page links — default), load_more (button), infinite_scroll (auto-load).
​
collection_load_more_label
text
default:"Load more pieces"
Button label in load_more mode.
​
collection_end_message
text
default:"You have reached the end."
End-of-list message in load_more and infinite_scroll modes.

​
What’s next

CSS tokens

Every --custom-property derived from these settings.

Section schemas

Settings and blocks count for every section.