Skip to content

select

Custom field type

All field types

One choice from a dropdown, or several when you allow it.

Written as
"Type": "select"
Valid on
Forms, and template fields, Datastore schema, and custom site settings
Stores
{{ select }} — the Liquid object a template reads from this field.
On a form
{{ select_field }} — the control object rendered on a Form. Not the same object as Stores.
Validators
same, not, minitems, maxitems, lte, lt, gte, gt, eq, different
Default value
One option value, or an array of them when AllowMultiple is set.

Properties

Accepted in addition to the shared properties every definition carries.

Property Required Description
Options — The options, written as one delimited string rather than an array.
Delimiter — Separates one option from the next.
ValueDelimiter — Separates an option's stored value from its label.
AllowMultiple — Lets the editor choose more than one.