# Radio field

📝

A **Radio** field is specifically designed to collect a single choice from a predefined list of options.

## [#](#overview)Overview

Radio fields display all available options at once and allow the user to pick exactly one, making them ideal when the list of choices is short and visibility of every option matters.

![image-20260527-095436.png](https://help.gocapable.com/images/9311cfbd-a852-4994-bfac-7c865bfdc397.webp)

---

## [#](#use-cases)Use cases

Typical use cases include:

* Selecting a status, category, or type
* Choosing a priority level (e.g. Low, Medium, High)
* Picking a response from a short, fixed list (e.g. Yes / No / Maybe)
* Approval decisions or routing choices
* Any single-answer question where users benefit from seeing all options up front

---

## [#](#configuration)Configuration

You have the following options available when using the radio input macro:

![image-20260527-095520.png](https://help.gocapable.com/images/d4156a8d-1a3f-4156-922f-4f3846ebeb35.webp)

| **Setting** | **Recommendation**                            | **Notes**                                                                     |
| ----------- | --------------------------------------------- | ----------------------------------------------------------------------------- |
| ID          | Use a stable, meaningful internal identifier. | Avoid renaming once the field is used in filters, reports, or templates.      |
| Label       | Use clear user-facing wording.                | For example: _Priority_, _Document type_, or _Approval decision_.             |
| Required    | Enable only when the value is essential.      | If enabled, provide a clear label and help text so users know what to select. |
| Options     | Keep the list short and mutually exclusive.   | Best for 2–5 options. For longer lists, consider a Select field instead.      |
| Placeholder | Add an example or prompt to guide the user.   | For example: Select the priority for this request                             |