Theme settings reference
The CBP-specific theme settings that control the API, debug mode, and key products.
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). There are two kinds: ordinary brand/content settings (safe to adjust), and a few CBP configuration settings (powerful — change with care).
Brand & content settings
These behave like any Shopify theme's settings:
| Group | Controls |
|---|---|
| Colours | Primary, neutrals, and semantic (success / warning / error) colours. Surfaced as CSS variables (RGB) and consumed across the theme. |
| Typography | Body and heading font families, sizes, weights, and line heights at the xs / sm / md / lg / xl scales. |
| Inputs | Input border radius (--style-border-radius-inputs). |
Header, footer, and the announcement bar are edited as section groups, not here — see Editing content & copy.
CBP configuration settings
The settings below are configuration, not content. A wrong value here can take down vehicle lookup or booking across the whole store. Change them deliberately, and test afterwards.
API settings
| Setting | ID | What it does |
|---|---|---|
| API base URL | api_base_url | The address of the production CBP backend API. All vehicle, postcode, and booking calls go here. |
| API dev base URL | api_dev_base_url | The API address used instead when debug mode is on (development/staging). |
Don't change the API base URL unless you are deliberately repointing the store to a different backend. If it's wrong, vehicle lookup and booking stop working everywhere.
Advanced
| Setting | ID | What it does |
|---|---|---|
| Debug mode | debug_mode | When on, the store talks to the dev/staging API and enables developer logging. Should be off in production. See Debug mode. |
Product configuration
| Setting | ID | What it does |
|---|---|---|
| Installation Service Product | installation_service_product | Tells the theme which product represents battery fitting. Powers the installation booking flow. |
| Debug Product | debug_product | A product used when generating HTML templates during server-side rendering. Developer-facing. |
If the installation-service product is ever replaced, this setting must be re-pointed at the new product or booking breaks. See The installation-service product.
For developers
- Schema:
config/settings_schema.json; data:config/settings_data.json. - CSS-variable bridge:
snippets/css-variables.liquid— colours exposed as RGB triplets, consumed viargb(var(--color-name)). - API settings consumed via
snippets/api-init.liquid; debug-mode side effects insnippets/development-mode.liquid. See The backend API and Debug mode. - Header/footer section groups:
sections/header-group.json,sections/footer-group.json.