Theme settings reference
Every global theme setting group - typography, colours, layout, spacing, products, API, and SEO - with IDs and defaults.
Theme settings reference
👤 Ops · 🛠 Dev
Global theme settings live under the gear icon at the bottom-left of the theme editor (or Customize → Theme settings). They fall into two kinds: ordinary brand/content settings (safe to adjust), and a few CBP configuration settings (powerful - change with care).
This reference documents every setting group, each setting, and its default, split by group in the same order they appear in the editor.
The groups
| Group | What it controls | ID prefix |
|---|---|---|
| Typography | Fonts, sizes, weights, line heights, colours for every text style (headings, body, buttons, links) - desktop and mobile. | font_*, color_h*, color_body_* |
| Colours | Primary, secondary, neutral, and semantic palette; input corner radius. | color_*, input_corner_radius |
| Layout & spacing | Page width and margin; module/heading/banner/gap spacing across breakpoints. | max_page_width, min_page_margin, spacing_* |
| Products, API & Advanced | The CBP-critical settings: key products, backend API URLs, and debug mode. | *_product, api_*, debug_mode |
| SEO & meta tags | Site identity, title/description templates, verification, Open Graph, Twitter/X, schema.org, favicons. | seo_*, og_*, twitter_*, schema_org_* |
The Products, API & Advanced settings are configuration, not content. A wrong value there can take down vehicle lookup or booking across the whole store. Change them deliberately and test afterwards.
Header, footer, and the announcement bar are edited as section groups, not here - see Editing content & copy.
Reading the tables
Each group page lists settings with:
- Setting - the label shown in the theme editor.
- ID - the key in
config/settings_schema.json/settings_data.json. - CSS variable - where applicable, the variable the value is exposed as (see
snippets/css-variables.liquid). - Default - the value shipped with the theme.
Theme metadata
The schema's first block isn't a settings group - it's theme identity, set by developers at release:
| Field | Value |
|---|---|
theme_name | Car Battery Pro |
theme_version | 0.5.0 |
theme_author | Conversion Kings |
For developers
- Schema:
config/settings_schema.json; saved values:config/settings_data.json. - Group and label strings resolve from
locales/en.default.schema.json(thet:keys). - CSS-variable bridge:
snippets/css-variables.liquid- colours are exposed as RGB triplets and consumed viargb(var(--color-name)). - API settings are consumed via
snippets/api-init.liquid; debug-mode side effects live insnippets/development-mode.liquid. See The backend API and Debug mode. - Header/footer section groups:
sections/header-group.json,sections/footer-group.json.