> 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

This document explains how to add and configure the Number to text field in a template.

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="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2Fei865ubzDmTwD4spK1Ak%2Fimage.png?alt=media&amp;token=79d06a36-d71e-4afc-b7ac-90ed4857a0a1" 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="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 %}

### 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.