> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/quick-start/form-field-types/radio-buttons-field.md).

# Radio buttons field

The **Radio buttons** field lets users select one single option from a list.\
All options are visible at once, making it easy for users to choose quickly.

***

### ✅ When to use Radio buttons

Use the Radio buttons field when:

* Only one option should be selected
* You have a small number of options (usually 2–5)
* You want all choices to be visible without clicking

**Common examples**

* Yes / No questions
* Contact preference
* Account type
* Delivery method

***

### ⚙️ How it works

1. Users see all available options
2. They select **one option**
3. Selecting a new option automatically deselects the previous one
4. The selected value is saved with the submission

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FUAAc1xDrAgWZBTgJ9cHC%2F2025-12-18_20-00-38.png?alt=media&amp;token=f9e828da-1525-46d9-83aa-6d527d8627b9" alt=""><figcaption></figcaption></figure>

***

### 🧩 How to add a Radio buttons field

1. Open your form in the editor
2. Click **Add element**
3. Select **Radio buttons**
4. Add your option labels
5. Configure other detail of the field
6. Click **Save**

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F70t29fxfbG9qFR1ap1lM%2F2025-12-18_20-01-27.png?alt=media&amp;token=39731c07-d5bc-4dad-95ea-5e08d51cc4eb" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FQjuj7jayONEoNRu584v4%2F2025-12-18_20-06-57.png?alt=media&amp;token=ca944cad-699c-452c-817b-27b18e50973e" alt=""><figcaption></figcaption></figure>

***

### 🛠️ Field settings

#### Placeholder text

Radio buttons do not use placeholder text.\
Instead, use a clear field label or description to explain what users should choose.

Label examples

* `How would you like us to contact you?`
* `Select your account type`

***

#### Default value (optional)

The default value lets you pre-select one option when the form loads.

Use a default value when:

* One option is the most common
* You want to guide users toward a recommended choice

**Examples**

* Default option: `Email`
* Default option: `Standard support`

⚠️ **Tip:** Avoid setting a default if the choice must be intentional.

***

#### ✅ Required field (recommended)

When enabled, users **must select one option** before submitting the form.

**Common use cases**

* Inquiry type
* Contact preference
* Service level

**Example**

* Users must choose either `Personal` or `Business`

***

#### Other option (optional)

The **Other option** allows users to select **“Other”** and enter a custom value.

When enabled:

* An **Other** radio option appears
* Selecting it reveals a text input

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FGJ17kliwuMNPhTC7u0o2%2F2025-12-18_20-08-47.png?alt=media&amp;token=e061d4a7-c77b-42fe-ba19-b7737ecde786" alt=""><figcaption></figcaption></figure>

**Example**

* Options: `Email`, `Phone`, `Live chat`, `Other`
* User selects **Other**
* User enters: `WhatsApp`

**Tip:** Always add a clear placeholder like `Please specify`.

***

#### 📐 Layout options

You can control how radio buttons appear in your form:

* **Number of options per line**\
  Display options in 1 or multiple columns
* **Column width**\
  Adjust how wide the field is (33%, 50%, or 100%)

Use these settings to match your store’s layout.

***

### 🌟Best practices

* Use **Radio** **buttons** instead of **Dropdown** for short lists
* Keep option labels short and clear
* Order options logically (most common first)
* Avoid using **Radio** **buttons** for long lists

***

### 🔀 Use Radio buttons with conditional logic

Radio buttons work perfectly with conditional display.

**Example**

If customers select option **Phone**, the **phone** field shows up.

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FN2B8PqAct2ZOF1JTOrI0%2F2025-12-18_20-11-38.png?alt=media&amp;token=121421f4-f907-4d2f-959f-d33243f35f39" alt=""><figcaption></figcaption></figure>

***

#### Need More Help?

If you still need assistance, please contact us at  <contact@globo.io>. Our team will be happy to help you resolve any issues or guide you further.
