Radio fields store one value chosen from a visible option group. Runtime users can see all choices directly and select one of them.
Use a radio field when the option list is short and the choices should be visible without opening a dropdown, such as yes/no-like categories, small priority lists, or simple review results.
Basic Settings
| Setting | Description |
|---|
| Name | The field label shown to users. It is required and should describe the selected business meaning |
| API Name | The stable technical name used by data APIs, scripts, formulas, imports, and integrations. It is required |
| Required | Requires users to choose one option before the record can be saved |
| Readonly | Shows the selected option but prevents users from changing it |
| Disabled | Makes the field unavailable for normal use |
| Hidden | Stores the selected value while hiding it from normal form pages |
Radio Field Config
| Setting | Description |
|---|
| Options | Defines the visible option group. Each option has a display label and a stored value |
| Validate Trigger | Controls when option validation runs: when the value changes, when the field loses focus, or when the record is submitted |
| Field Color | Sets the display color used for the field |
| Invalid Option Message | Custom message shown when the selected option is invalid or no longer available |
| Help Text | Helper copy shown near the field. Use it to explain the difference between choices |
Options
| Part | Description |
|---|
| Label | The text shown next to the radio button |
| Value | The stored value used by records, APIs, scripts, imports, and integrations. Keep it stable after data is created |
| Add Option | Adds one option row to the list |
| Batch Insert | Adds multiple options at once. Use one option per line, or Label:value when the stored value should be explicit |
| Batch Copy | Copies the configured option list for reuse |
Common Examples
| Scenario | Options |
|---|
| Review result | Approved, Rejected, Needs Changes |
| Priority | Low, Medium, High |
| Customer type | New, Existing |
| Visibility | Public, Internal |
Configuration Tips
| Tip | Description |
|---|
| Use radio for short lists | If the list is long, use a select field instead |
| Keep labels concise | Radio options are displayed together, so short labels scan better |
| Keep values stable | Values are used by data APIs and automation; avoid changing them after records exist |