> 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/dropdown-field.md).

# Dropdown Field

This document explains how to add and configure the Dropdown field in a template, including options, multiselect, and custom values.

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

In the envelope, it’s rendered as a dropdown. After selection, it’s shown as regular text.

You can place this field in:

* structured documents
* PDF documents

### Add a dropdown field

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

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

{% column width="50%" %}

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FSaD0DNGP2EJoC9tAFfLj%2Fimage.png?alt=media&amp;token=d910a1cb-9ff0-48ed-9fee-54ba70be75a0" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Field settings

Click on the placed field to reopen settings menu.

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

* **Name** — field name shown in the document
* **Role name** — role that fills the field
* **Placeholder** — hint text shown before input (if empty, **Name** is used)
* **Option 1**, **Option 2**, etc. — values available for selection
* **Add option** — adds more options
* **Optional** — whether filling the field is required
* **Multiselect** — allows selecting multiple values
* **Allow custom values** — allows free text input in addition to predefined options
* **Search** — makes the field available for search/filtering in the mailbox UI (if enabled in your setup)

{% hint style="warning" %}
You can’t enable **Multiselect** and **Allow custom values** at the same time.
{% endhint %}
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FOSwTMid4kSNCdN8OO9D7%2Fimage.png?alt=media&amp;token=a6aaafc9-a062-4af2-9f0d-5f82db5563d5" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Limits:

* minimum: **1** option
* maximum: **100** options per field
* each option must be non-empty and **1–50** characters
  {% endhint %}

#### Links inside a dropdown field

If the selected value contains a URL, it is rendered as a normal browser link (blue + underline).

* You can open the link from the right-click context menu (any role).
* You can open the link with a direct click only if the field is inactive.