{
  "type": "select",
  "id": "items_layout",
  "label": "Layout",
  "options": [
    {
      "value": "portrait",
      "label": "Portrait",
      "kiwi_extra": {
        "icon": "fa fa-portrait"
      }
    },
    {
      "value": "landscape",
      "label": "Landscape",
      "kiwi_extra": {
        "icon": "fa fa-image"
      }
    }
  ],
  "kiwi_extra": {
    "labeled": false
  },
  "default": "portrait"
}
The select input type allows users to choose from a predefined list of options.

​
Properties

​
type
string
required
Must be set to “select”.
​
id
string
required
Unique identifier for the setting.
​
label
string
required
The label shown in the theme editor.
​
options
array
required
Array of option objects, each containing:
  • value: The value stored when this option is selected
  • label: The text shown in the dropdown. It may be translated using t: prefix plus a valid key from schema translation files. More details can be found in Locales.
​
default
string
Default selected option value. Must match one of the option values.
​
info
string
Additional information shown below the select input.
​
kiwi_extra
object
Additional properties for the select input. Currently supported:
  • hidden: boolean value, indicates whether this setting should be displayed in Theme Editor’s configuration bar
  • labeled: boolean value, indicates if text labels should be shown together with icons on each option
  • validations: Apply validations to this setting before saving. Currently supported:
    • required: Boolean value. If true, one option must be chosen to be valid