Radio

The Radio field lets users choose one option from a visible list of radio buttons. All options are shown at once - no clicking to open a menu - which makes it fast to scan and select.

What it is

A Radio field displays a short list of options as radio buttons. Users click one to select it, and clicking another automatically deselects the previous choice - only one selection is ever active at a time. You define the list of options yourself, and you can set one as the default so it's pre-selected on new records.

Radio buttons work best with 5 or fewer options . If your list is longer, use a Dropdown field instead - it collapses the list to save space on the form.

When to use it

Status fields - New, In Progress, Done (users can see all options without opening a menu)
Priority levels - Low, Medium, High for tasks or support tickets
Rating scales - 1, 2, 3, 4, 5 for satisfaction surveys or quality scores
Type or category - when you have a small, fixed set of categories and want them always visible
Approval stages - Pending, Approved, Rejected

Working with options

Options are entered as a comma-separated list and are case-sensitive. For example: New, In Progress, Done.

Once an option is saved and records are using it, you cannot rename it. If you added Pending but later want to call it Hold, these are treated as two different values - existing records will still show Pending. To migrate records to the new value, you can either use the API to update them in bulk, or filter your records by the old value and update each one manually.

Plan your option values carefully before you start entering data. Renaming a value later requires updating every record that uses it.

Settings

Options - enter your list of choices; separate each option with a comma or press Enter after each one
Default Value - choose which option is pre-selected when a new record is created; leave blank if no default should be set
Label - the name shown above the field in forms and layouts
Required - prevents saving the record unless an option is selected
Conditional - show or hide the field based on another field's value

Example

In a project management app, you add a Radio field labeled Priority to your Tasks object type. Your options are Low, Medium, and High. You set Medium as the default value so most tasks start there and your team only has to change it when something is urgent or low-priority. On the task form, all three options are visible as radio buttons - a quick glance shows what's selected without opening any menus.