settings_data.json
The 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 color_page_bg
in settings_data.json
:
Any time that the value of color_page_bg
is changed in the theme editor, settings_data.json
is updated with the new value.
The settings_data.json
file is located in the config
directory of the theme:
The settings_data.json
file has two parent objects:
Object | Description |
---|---|
current |
Contains all of the setting values that are currently saved in the theme editor. |
presets |
Contains an object for each theme style. Each object is in the same format as current . |
For example:
When working with the settings_data.json
file, you should familiarize yourself with theme styles.
Theme styles
Anchor 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 settings
Anchor 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.