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

# Number Field

Use the **Number field** to collect numeric values during envelope processing.

You can place this field in:

* structured documents
* PDF documents

### Add a number field

{% columns %}
{% column %}

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

{% column %}

<figure><img src="/files/lstv17kYp1L7FueQxz8B" 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)
* **Tooltip** — additional hint shown on hover
* **Optional** — whether filling the field is required
* **Search** — makes the field available for search/filtering in the mailbox UI (if enabled in your setup)
* **Adapt to the local format** — formats numbers using the participant’s region settings
* **Show decimal zeroes** — adds trailing zeroes to match **Precision**
* **Precision** — number of decimal places allowed (leave empty for no limit)
* **Min** — minimum allowed value (leave empty for no limit)
* **Max** — maximum allowed value (leave empty for no limit)
  {% endcolumn %}

{% column width="41.666666666666664%" %}

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

{% hint style="info" %}
In the envelope view, numbers use the region selected on the **User profile** page.

In printable versions, numbers always use the platform region standard.
{% endhint %}

#### Precision behavior

If the value has more decimals than **precision**, extra decimals are trimmed.

No rounding is applied.

Example:

* `1.99` → `1.9` when **precision** is `1`
* `1.99` → `1` when **precision** is `0`

{% hint style="danger" %}
**Limits**:

The maximum allowed character count is **15** (IEEE 754).

This includes decimal places.

Example: with **precision** = `3`, the value `999999999999999` becomes `999999999999.000`.
{% endhint %}