Theme settings

The theme editor writes setting values to config/settings_data.json. Do not edit that file by hand, because the theme pull workflow overwrites it.

Read a setting in Liquid as settings.<id>.

Groups

Leave Development Mode off

is_dev_mode, labelled "Access site through BrowserSync?", replaces the styles.css bundle with a script at /dev/main.js:

{% if settings.is_dev_mode %}
  <script type='text/javascript' src='/dev/main.js' defer></script>
{% else %}
  {%- render 'vite-tag' with 'styles.css', preload_stylesheet: true -%}
{% endif %}

That path belongs to a BrowserSync setup the project no longer uses. Turning the setting on removes the theme's stylesheet and loads a file that does not exist.

All three layouts read it, at about line 310 of each.

Rewards Tiers

The group has four tiers with the same eight settings each, plus four settings for the homepage section.

layout/theme.liquid writes these values to window.theme.cartRewardBanner, and src/components/cart-reward-banner/ reads them.

Purchase gift, in the Products group

layout/theme.liquid writes these values to window.theme.gift_product and window.theme.labels.product_gift_skip_cta_label, and src/components/purchase-gift-manager/ reads them.

Cart thresholds

These settings are separate from Rewards Tiers and control different wording.

Medispa

The group holds settings for three separate features.

Live booking availability is a social proof display. Its settings are show_booking_availability, booking_availability_operating_mode, booking_availability_demo_tick_timer_secs_minimum and _maximum, booking_timeframe_days, start_date_type, booking_availability_low_threshold, booking_availability_low_copy, booking_availability_anon_name and booking_availability_user_name.

Booking toasts use show_booking_toasts, booking_toasts_lifespan_seconds, booking_toasts_timestamp_interval_seconds, booking_toasts_visible_count, booking_toasts_just_now_label, booking_toasts_copy and booking_toasts_custom_css.

Booking forms use medispa_booking_form_id, medispa_booking_form_id_mobile and medispa_zapier_webhook_url.

booking_availability_operating_mode has a demo mode, which uses the two tick timer settings to generate activity. Check which mode is selected before you treat the displayed availability as real.

Medispa Deposit

layout/theme.liquid writes these values to window.theme.labels.medispa, and snippets/medispa-calendar-config.liquid adds them to the calendar config. Product metafields override them for each treatment.

Klaviyo

src/entrypoints/klaviyo-popup-trigger.ts reads these through window.offerPopupConfig. It does nothing unless both the desktop and the mobile ID are set.

Popup Manager

Known schema problem

config/settings_schema.json contains one setting with an invalid type, which Theme Check reports as a ValidJSON error:

{ "type": "image", "id": "pluginseo_structuredDataLogo.png", "label": "Logo" }

image is not a valid setting type. The valid type is image_picker. The setting belongs to the Plug in SEO app's structured data group. The theme works with it in place, but do not copy it, and expect Theme Check to keep reporting it.

Related

• Metafields and metaobjects covers per-product overrides.
• JavaScript globals shows where these values end up in the browser.