Radio buttons

The Radio buttons element lets users select a single option from a list. Unlike Checkbox, radio buttons only allow one selection.

Basic

Basic settings define the element's core properties.

Label

The label text shown above or beside the field (depending on the Label position setting). It also:

• Helps identify the field in the admin interface
• Appears as a heading in the form preview panel on the right

Unique Name

The internal identifier for this element. The name is auto-generated by default, but you can edit it manually. Naming rules:

• Lowercase letters, numbers, and underscores only
• Must start with a letter

This name references the field in email templates.

Label vs. Unique Name

The Label is the text shown to users, while the Unique Name is the internal identifier. For example, the Label could be "Gender" and the Unique Name gender.

Options

The core configuration of the Radio buttons element, managing the options in the list. Each option has two parts:

• Label (display text): The text users see in the list
• Value (submitted value): The value sent on submission

Label vs. Value

For example, the Label could be "Male" and the Value male. Users see "Male", but male is submitted.

By default, the Value matches the Label (the Value input is disabled). Enable the Customize values toggle to set a different Value for each option.

Option operations

Each option provides these action buttons:

Button	Description
✓ (Default value)	Set as the default selected option
🗑 (Remove)	Delete this option
＋ (Add)	Add a new option below
📄 (Duplicate)	Duplicate this option
≡ (Sort)	Drag to reorder options

Add options in bulk

Beyond adding options one by one, you can also:

• Add option: Add a single blank option
• Add bulk options: Add many options at once

Description

Explanatory text shown beneath the field, providing help and context.

Validate

The Radio buttons element supports a single validation rule:

Validator	Description
Required	Requires the user to select an option

Radio buttons vs. Checkbox

Radio buttons allow only one selection, so there is no Minimum/Maximum selection count (that validation is only available in Checkbox).

Styles

Style settings control the element's appearance.

Options layout

Controls how the radio button options are arranged. Available options:

• Inline: Options in a single row (default)
• One option per line: Each option on its own line
• 2 columns ~ 10 columns: Options in a 2-10 column grid

Layout suggestions

Use Inline or One option per line for a few options; use a multi-column layout for many options to save space.

Label position

Controls where the label appears. Available options:

• Inherit: Uses the global configuration in Form style settings
• Vertical: Label above the options
• Horizontal: Label to the left of the options
• Hidden: Label hidden

Logic

Enable conditional logic

When enabled, configure rules to show or hide this element based on the user's input in other fields.

Rule match mode

After enabling conditional logic, first choose the match mode:

• Match any condition (any): The element shows/hides when any single rule is satisfied
• Match all conditions (all): The element shows/hides only when all rules are satisfied

Configure rules

Each rule has three parts:

Part	Description
Field	Pick a target field from the dropdown (shows the field's Label)
Operator	The comparison condition
Value	The target value to compare against

Supported operators

Operator	Description
is	Triggers when the field value equals the specified value
is not	Triggers when the field value does not equal the specified value
is empty	Triggers when the field value is empty
is not empty	Triggers when the field value is not empty

Add and manage rules

• Click Add logic rule to add a new rule
• Click the 🗑 button on the right of a rule to delete it
• Click the ＋ button to add more match conditions

Example

Radio buttons are often used as a trigger. For example, show the "Men's clothing size" field only when the user selects "Male" in "Gender":

• Match mode: Match any condition
• Field: Gender
• Operator: is
• Value: Male

Data

Dynamic default value

When enabled, a Parameter name input appears. Enter the name of a URL parameter, and the system reads that value from the URL and auto-selects the matching option.

For example, if you enter gender in Parameter name and the user visits:

https://yoursite.com/contact?gender=male

then the option with Value male is auto-selected.

Show in email

Controls whether this field's value appears in the email notifications (enabled by default). When disabled, the field's value is excluded from the submission email.

Advanced

Unique ID

The element's unique ID, auto-generated by the system. Read-only.

No filters

The Radio buttons element draws its values from preset options and needs no filter pre-processing, so the Advanced tab has no Filters.

Next steps

• Checkbox — Multi-select
• Select — Dropdown single-select
• Multiselect — Dropdown multi-select