Skip to main content

Select

Select fields store one value chosen from a configured option list. Runtime users choose the value from a dropdown.

Use a select field when the choices are fixed or managed by the form designer, such as status, priority, category, source, or level.

Basic Settings​

SettingDescription
NameThe field label shown to users. It is required and should describe the selected business meaning
API NameThe stable technical name used by data APIs, scripts, formulas, imports, and integrations. It is required
RequiredRequires users to choose one option before the record can be saved
ReadonlyShows the selected option but prevents users from changing it
DisabledMakes the field unavailable for normal use
HiddenStores the selected value while hiding it from normal form pages

Select Field Config​

SettingDescription
OptionsDefines the selectable option list. Each option has a display label and a stored value
PlaceholderPrompt text shown before users choose an option
Show SearchAllows users to search options in the dropdown. This is useful when there are many options
Validate TriggerControls when option validation runs: when the value changes, when the field loses focus, or when the record is submitted
Input StatusAdds a visual status to the field, such as warning or error
Invalid Option MessageCustom message shown when the selected option is invalid or no longer available
Field ColorSets the display color used for the field
Help TextHelper copy shown near the field. Use it to explain how users should choose an option

Options​

PartDescription
LabelThe text shown to users in the dropdown
ValueThe stored value used by records, APIs, scripts, imports, and integrations. Keep it stable after data is created
Add OptionAdds one option row to the list
Batch InsertAdds multiple options at once. Use one option per line, or Label:value when the stored value should be explicit
Batch CopyCopies the configured option list for reuse

Option Examples​

LabelValueUse
NewnewInitial status
In Progressin_progressWork has started
CompletedcompletedWork is finished
HighhighHigh priority

Configuration Tips​

TipDescription
Keep values stableRename labels when needed, but avoid changing stored values after records exist
Turn on search for long listsSearch improves usability when users must choose from many options
Use clear invalid messagesExplain what users should do when an old option was removed or disabled