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

# Number to text Field

Use **Number to text field** to display a numeric value in words.

The field uses the value of another field. Participants cannot edit the generated text.

You can place this field in:

* structured documents

### Add a Number to text field

{% columns %}
{% column %}

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

{% column %}

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

### Field settings

Click the placed field to reopen the settings menu.

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

* **Name** — field name shown in the document
* **Tooltip** — additional hint shown on hover
* **Document** — document containing the source field
* **Transcript of** — **Number**, **Currency**, or **Formula** field to convert
* **Currency** — currency or measurement unit in the generated text
* **Language** — language used for the generated text
* **Search** — makes the field available for mailbox search and filtering
  {% endcolumn %}

{% column width="41.666666666666664%" %}

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

### Source field rules

Select a **Number**, **Currency**, or **Formula** field as the source.

{% hint style="info" %}
The template must contain a supported source field before you add **Number to text field**.
{% endhint %}

If the field is inside a dynamic table, select a source field from:

* the same dynamic table
* outside all dynamic tables

You cannot delete a source field while **Number to text field** uses it.

### Currency and language

Select **Currency** to convert an amount with its currency unit.

* `100.00 UAH` → `One hundred hryvnias, 0 kopecks`
* `100.00 USD` → `One hundred US dollars, 0 cents`

Leave **Currency** empty for values without a currency unit.

* `9` → `nine`
* `25` → `twenty-five`

{% hint style="info" %}
Select **Language** to set the output language. By default, DocStudio uses the interface language from the user profile.
{% endhint %}

### Field behavior

When a participant fills the source field, DocStudio fills **Number to text field** automatically. If the source value changes, DocStudio updates the generated text. The generated field remains read-only.

#### Decimal values

With **Currency** selected, DocStudio rounds the minor currency unit to two decimal places.

* `72.678 UAH` → `Seventy-two hryvnias, 68 kopecks`

Without **Currency**, DocStudio converts the decimal value without rounding.

* `72.678` → `seventy-two point six hundred seventy-eight`

{% hint style="info" %}
**Search** is unavailable for this field in **Quick send**.
{% endhint %}