Theme settings

Theme settings are defined in config/settings_schema.json and their saved values live in config/settings_data.json. A merchandiser edits them through the theme editor, under Theme settings in the left sidebar.

Never hand-edit config/settings_data.json. Shopify writes it, and the next theme editor save or theme pull overwrites your change.

Regenerate this page

python3 -c "
import json
for s in json.load(open('config/settings_schema.json')):
    n = s.get('name', s.get('theme_name', 'theme_info'))
    ids = [x.get('id') for x in s.get('settings', []) if x.get('id')]
    print(f'{n} :: {len(ids)} settings')
    for i in ids: print('   ', i)
"

Groups

The schema has 30 groups holding around 300 settings between them.

Rewards Tiers

The group holds four tiers with eight settings each, all following the same naming pattern.

The group also has four settings for the Unlock Free Bonus section: unlock_free_bonus_title, unlock_free_bonus_description, unlock_free_bonus_cta and unlock_free_bonus_link.

Encouragement messages accept {remaining_amount} and {threshold_money} placeholders.

A tier with a blank tier_N_price_threshold is skipped. A tier with a blank tier_N_title is not pushed into window.theme.cartRewardBanner.rewardTiers.

Medispa

booking_availability_operating_mode decides whether the numbers customers see reflect real bookings. Confirm which mode the live theme uses before describing them as real.

Medispa Deposit

Both money settings are in dollars. The calendar prefers the selected product's own metafields and falls back to these.

Popup Manager

GTM Tracking

SEO - Exclusions

Two further noindex rules are hard-coded in layout/theme.liquid and cannot be edited here. Products tagged no-index are excluded, and any page showing a tag filter is excluded.

Adding a setting

1. Add it to the right group in config/settings_schema.json.
2. Read it in Liquid as settings.your_setting_id.
3. If JavaScript needs it, write it to window.theme and declare it in src/@types/global.ts.
4. Add a row here and to the relevant Operations page.

Choose theme settings only for values that describe presentation across the store. A value describing one product belongs on the product as a metafield. A value describing one instance of a section belongs in that section's own schema.