# Text Field

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

<figure><img src="/files/fJCvJuTi9HuoBBAmQSly" alt=""><figcaption></figcaption></figure>

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**.

### 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="/files/gWsOWZ95XlnY6Zk89R3V" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.docstudio.com/user/template-builder/template-dynamic-fields/text-field.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.