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 two parent objects:
||Contains all of the setting values that are currently saved in the theme editor.|
||Contains an object for each theme style. Each object is in the same format as
When working with the
settings_data.json file, you should familiarize yourself with 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 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.