Skip to main content

settings_presets.json

The settings_presets.json file contains the setting values for theme styles based on the settings included in settings_schema.json.

Location​

The settings_presets.json file is located in the config directory of the theme:

Directory
└── theme
    ...
    ├── config
        ├── settings_data.json
        ├── settings_presets.json
        └── settings_schema.json
    └── locales

Schema​

The settings_presets.json file has the following parent objects:

ObjectDescriptionRequired
presetsContains an object for each theme style. Each object is in the same format as the current.Yes
<StyleName>Contains an object for a theme style. Each object is in the same format as the current.Yes

For example:

json
{
  "presets": {
    "<StyleName>": {
      "color_body_bg": "#FFFFFF",
      ...
    },
    "Default": {
      "color_body_bg": "#FFFFFF",
      ...
    },
    "Impress": {
      "color_body_bg": "#FFE6EB",
      ...
    }
  }
}
warning

The Default style represents the style composed of all default configurations. When there is a settings_presets.json file, there must be a Default style.

Usage​

When you're working with the settings_.json file, you should familiarize yourself with the following concepts:

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​

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.

On this page