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

# Lookup Field

Use **Lookup field** to auto-fill a value from a **Dictionary field** selection.

It returns a value from the selected **Column name** in the row chosen in the parent dictionary field.

You can place this field in:

* structured documents
* PDF documents

### Add a lookup field

{% columns %}
{% column %}

1. Open the template in edit mode.
2. Find the **Lookup field** in the **Fields panel** and add it to the template.\
   — Choose column from dictionary with required information
3. Click **Save**.
   {% endcolumn %}

{% column %}

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

{% hint style="danger" %}
To add a lookup field, the template must include at least one dictionary field.
{% endhint %}

### Field settings

Click on the placed field to reopen settings menu.

{% columns %}
{% column %}

* **Name** — field name shown in the document
* **Placeholder** — hint text shown before input (if empty, **Name** is used)
* **Tooltip** — additional hint shown on hover
* **Optional** — whether filling the field is required
* **Allow custom values** — allows free text input in addition to lookup values
* **Search** — makes the field available for search/filtering in the mailbox UI (if enabled in your setup)
* **Document** — document where the parent dictionary field is located
* **Related to** — parent dictionary field
* **Column name** — dictionary column to return
  {% endcolumn %}

{% column %}

<figure><img src="/files/7FGvDXzD7ZwZ6ew27A9c" alt="" width="306"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
If the parent dictionary enforces optionality or custom values, the same rules are enforced for related lookups.
{% endhint %}

#### Links inside a lookup field

If the populated 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.