settings_data.json file contains the setting values for a theme based on the settings included in settings_schema.json.
For example, you can use the following theme setting to allow a merchant to choose a color for the page background:
This adds an entry for
Any time that the value of
color_page_bg is changed in the theme editor,
settings_data.json is updated with the new value.
settings_data.json file is located in the
config directory of the theme:
settings_data.json file has the following parent objects:
||Contains all of the setting values that are currently saved in the theme editor.||Yes|
||Contains an object for each theme style. Each object is in the same format as
||Contains setting values for platform-controlled settings.||No - this object is added by Shopify if a merchant uses a platform-controlled setting.|
When you're working with the
settings_data.json file, you should familiarize yourself with the following concepts:
Theme stylesAnchor link to section titled "Theme styles"
A theme style is a collection of theme setting defaults that enable merchants to easily change the general look and feel of the theme through the theme editor when getting started.
Selecting a theme style updates the
current object to use the associated theme style values. However, only values from presentational settings are updated.
Presentational settingsAnchor link to section titled "Presentational settings"
Presentational settings are settings that are related to a visual aspect of the theme. Examples of presentational settings include the color and font applied to text, or whether a specific element is visible.
The following input types are presentational settings. Values for these settings are overwritten when switching theme styles.
Platform-controlled settingsAnchor link to section titled "Platform-controlled settings"
In the theme editor, Shopify exposes a custom CSS setting at the theme and section level. Any custom CSS the merchant adds at the theme level is stored in the
This setting is intended to enable users to customize the look and feel of their storefront without editing theme code. As a theme developer, you shouldn't add this setting, or edit the value of this setting after it's set. Instead, you should use dedicated CSS assets and
stylesheet Liquid tags, and introduce customization options for CSS in these areas using theme settings.
LimitationsAnchor link to section titled "Limitations"
settings_data.json file size can't exceed 1.5MB.