Theme settings schema

Definition

The theme settings schema declares the store-wide options a Shopify theme exposes in the theme editor — colors, typography, layout, cart behavior — as a JSON file of grouped, typed inputs. Values are saved per theme and read anywhere in Liquid through the settings object, which makes it the one place a merchant changes something that applies to every page.

Documented at https://shopify.dev/docs/storefronts/themes/architecture/config/settings-schema-json.

How we've used it

Global settings are a shared resource, and that's the trap. A premium theme will generate its entire design system from them — the color ramp with its derived tints and alphas, the type scale, the spacing and grid tokens — inside one snippet that runs in the head of every layout. That snippet is also the only place a licensed brand typeface can be declared without loading after first paint, so the font declarations get appended there deliberately, at the tail of the vendor's own token block, where they reach the password and landing layouts too. The counter-pattern shows up just as often: one global value can't serve a four-up gift-guide grid and a two-up mobile carousel, so that setting moves down onto the section and out of the global schema.

Builds using it

One gated build uses it; its page follows.

Related entities

CSS custom properties · Liquid section schema and settings · Theme architecture · Theme sections