Dropdown Field × Mattrbld

The Dropdown field allows selecting a single value from a list of values.

Editing UI Widget

This field is displayed as a dropdown menu labelled with the field’s label in the Content Editor.

Output Format

The Dropdown field outputs the selected value in its predefined type.

Options

The following options are available for this field (default values shown):

{
  "filterable": false,
  "removable": false,
  "placeholder": "Select a value…",
  "options": []
}

filterable: whether or not to show an input field for filtering the values of the dropdown menu
removable: whether or not to include an entry in the dropdown field that allows resetting the value to null
placeholder: the placeholder text to use while the dropdown’s value is null, i.e. no value is selected
options: the options available in the dropdown field. May be either an array of values, an array of { label, value } objects, or an object containing a path to a JSON file and a key to look an options array up under

Validation

The following validation options are available for this field (default values shown):

{
  "required": false
}

Notes

If you only have a couple of options to select from, or want users to be able to select multiple values, you may be looking for the Radio Group and Checkboxes fields.

If you configure the field to pull options from a file by providing a path to a JSON file and a key in options.options, make sure that the value of that key is an array of non-object values like numbers or strings, or an array of { label, value } objects. JSON-files consisting of a single array are currently unsupported. The value of label is what will be displayed to the user, while the value of value is what will be stored when that option is selected.

Version History