> 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

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="/files/tobmiwrw82MnnOgSFP2z" 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="/files/zbzipadZTNnY8g8oar3M" 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.