> For the complete documentation index, see [llms.txt](https://support.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.docstudio.com/user/template-builder/template-dynamic-fields/choice-field.md).

# Choice Field

Use **Choice field** to let a participant pick one value from a predefined list.

In the document, it’s rendered as a set of radio buttons.

You can place this field in:

* structured documents
* PDF documents

### Add a choice field

{% columns %}
{% column %}

1. Open the template in edit mode.
2. Find the **Choice field** in the **Fields panel** and add it to the template.
3. Configure the field and click **Save**.
   {% endcolumn %}

{% column %}

<figure><img src="/files/8SEN7jxWcDKqDTt8FmjG" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Field settings

Click on the placed field to reopen settings menu.

{% columns %}
{% column width="58.333333333333336%" %}

* **Name** — name of the option value available for selection
* **Role name** — role that fills the field
* **Group name** — name of the options group shown to the user
* **Search** — makes the field available for search/filtering in the mailbox UI (if enabled in your setup)

{% hint style="info" %}
**Group name** must be between **3** and **40** characters.
{% endhint %}
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/FgvxGLRbotucq3vzrpBF" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}