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

# Text Field

This document explains how to add and configure the Text field in a template, including limits and link behavior.

Use **Text field** to collect free-form text from participants during envelope processing.

You can place this field in:

* structured documents
* PDF documents

### Add a text field

{% columns %}
{% column %}

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

{% column %}

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FsBwX2ZxOSZCILKQeW74M%2Fimage.png?alt=media&amp;token=5fea7e5e-8864-48bc-b999-98f5ad158b4a" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Field settings

You can change these settings later. Click the field in the document to reopen properties.

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

* **Name** — field name
* **Role name** — role that fills the field
* **Placeholder** — hint text shown before input (if empty, **Name** is used)
* **Tooltip** — additional hint shown on hover
* **Optional** — whether filling the field is required
* **Multiline** — switches between single-line and multi-line input
* **Search** — makes the field available for search/filtering in the mailbox UI (if enabled in your setup)
* **Pattern** — input format constraint (for example, `UUID`, `EDRPOU`, `IPN`)
* **Fill with profile data** — auto-fills the field from the participant profile (for example, first name, last name, email, phone)
* **Min** — minimum number of characters (leave empty to disable the minimum)
* **Max** — maximum number of characters (leave empty to keep the default limit)
  {% 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%2FnQdj9LttDiXUxivg9wzI%2Fimage.png?alt=media&amp;token=7fc923ec-2211-4622-a73a-d93499808133" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Default limits:

* single-line: **1000** characters
* multiline: **5000** characters
  {% endhint %}

#### Links inside a text field

If a participant enters 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.