> 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

This document explains how to add and configure the Currency field in a template, including local formatting and limits.

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="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FTapXuW9W9Ll51MWN4yrT%2Fimage.png?alt=media&amp;token=7ba4ad72-6f0a-4569-989d-35ab6c40290e" 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="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FNuqA5gprMNJCPsfVHSMr%2Fimage.png?alt=media&amp;token=4e5752b6-2c6a-489d-bc6f-1c6ea00ec716" 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 %}