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

# Currency Field

Use **Currency field** to collect monetary amounts during envelope processing.

You can place this field in:

* structured documents
* PDF documents

### Add a currency field

{% columns %}
{% column %}

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

{% column %}

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

### Field settings

Click on the placed field to reopen settings menu. In the envelope view, number formatting depends on the region selected on the **User profile** page.

{% 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
* **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/PMrAEB2D7ZC9lfC5gSC4" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="warning" %}
The maximum allowed character count is **15** (IEEE 754).

This includes decimal places.

Example: the value `999999999999999` becomes `9999999999999.00`.
{% endhint %}