Selection Fields
Selection fields let the end user choose from a predefined set of options.
Select field (dropdown)
A dropdown menu where the end user picks a single option.
Settings:
Label — The label displayed above the field.
Help text — Explanatory text shown below the field.
Required — Makes a selection mandatory.
Options — The list of choices. Each option has a label (shown to the end user) and a value (stored in the submission). One option can be marked as the initial value, which pre-selects it when the form loads.
Radio button field
A set of radio buttons where the end user picks a single option. All options are visible at once, making it easier to compare choices than a dropdown.
Settings:
Label, Help text, Required — same as the Select field.
Options — Same structure as the Select field. One option can be set as the initial value.
Checkbox field
A group of checkboxes where the end user can select one or more options.
Settings:
Label, Help text, Required — same as the Select field.
Options — Each option has a label and a value. One or more options can be set as initial values, pre-checking them when the form loads.
API search field
A search input that fetches options dynamically from an external HTTP endpoint as the end user types.
This is useful when the list of options is too large to define statically, or when it is managed by another system (e.g. a product catalogue or a CRM).
Settings:
Label, Placeholder, Help text, Required — standard settings.
Endpoint URL — The URL of the external service that returns matching options. The end user's search term is sent as a query parameter.
Search parameter name — The name of the query parameter used to send the search term to the endpoint.
Label attribute — The field in the response object to display as the option label.
For autocomplete variant: The API search field also has an autocomplete mode, which populates the field with a single value selected from the search results rather than allowing free text.
Whitelisting the endpoint
External endpoints called by the API search field must be added to the Whitelisted endpoints list in the admin settings before they can be used. This prevents the field from being used to make requests to arbitrary URLs.