Skip to main content
The select input type allows users to choose from a predefined list of options.

Properties

string
required
Must be set to โ€œselectโ€.
string
required
Unique identifier for the setting.
string
required
The label shown in the theme editor.
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.
string
Default selected option value. Must match one of the option values.
string
Additional information shown below the select input.
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