Use Radio buttons for a short list where visitors should see all alternatives and choose one. Each choice has a readable label and a stable saved value.
Availability: Core (Free).
Add and configure the field
- Open the form in Build and add Radio buttons from Add fields.
- Select its canvas card to open Field options, then configure the controls below.
- Save the form and check its saved Preview and embedded page.
Field-specific settings
| Setting | What it does |
|---|---|
| Choice source | Manual uses your configured list. WordPress taxonomy uses terms from an available taxonomy. |
| Taxonomy | Choose the taxonomy when using WordPress taxonomy. Saved choices use term IDs as string values and current term names as labels. |
| Exclude terms | Optionally omit selected terms from the taxonomy-backed list. |
| Choices | Use Manage choices to edit the manual labels and stable saved values. Bulk add and predefined lists are described in the shared choices guide. |
| Default choices | Choose zero or one manual default. Clear defaults starts without a selected answer. Taxonomy-backed fields do not use a static default selection. |
| Show clear selection | When enabled on an optional field, offers Clear selection while a choice is selected. Required fields suppress it. The control needs JavaScript. |
Applicable shared options
This field also provides Description placement, Validation message placement, Label, Description, Required, Required message, Invalid value message, CSS classes, Hide label, Admin label, Visibility. See common field options for their behavior.
Review Visible, Hidden and Internal before changing presentation. Static hiding differs from conditional applicability.
Dynamic population offers Disabled, Parameter, Current user. Its applicable Parameter name and User property controls select the initial source; submitted or cleared answers are not refilled.
No duplicates and Duplicate value message require Pro. They compare accepted entries for this form and field, separately from Required.
Answers and behavior
The answer is one saved choice value. Native radio interaction allows one selected option in this field, and clicking an already selected radio does not ordinarily unselect it. Enable Show clear selection when an optional answer needs an explicit way back to blank.
Required means one answer is needed, not that every option is required. A required group suppresses the clear-selection action. Defaults are initial selections; clearing an optional answer after validation does not restore its old default.
The builder canvas can show only the first five options with a more-choices indicator. That is an editing preview limit; the actual public form and saved Preview retain the complete choice list.
Example and checks
For Contact preference, add Email and Phone with values email and phone. Keep the wording short and explain whether this is only a preference. If an answer is optional, consider Show clear selection.
Test selecting each option with mouse and keyboard, clearing where available, and submitting without a required answer. Inspect conditional rules after removing or changing saved values. For a long list, Dropdown may be easier to scan.
Use the testing checklist to check validation and the saved entry. Explore all fields provides live examples.
