# Text tags Introduction

BoldSign text tags are a combination of text and symbol that can be placed anywhere in the document by specifying the location, size, and type of form fields. It is an alternative way to add fields to your documents through API requests.

In order to detect text tags in a document, set the property `UseTextTags` to true in the `SendForSign` request. This will convert all tags defined in the document into UI form fields, which can then be filled by the signers.

When the `UseTextTags` property is enabled, there is no need to set the form fields property for every recipient. The fields will be auto filled based on text tags present in the document.

{% nestedtable %}

- {% arguments name="UseTextTags" /%}{% batch datatype="boolean" /%}
- When enabled, it will convert all the tags defined in the document to BoldSign form fields. The default value is `false`.

{% /nestedtable %}

***Note:*** The text tags that are placed in the document will not be removed, so it is recommended to set the color of the text tags to match the background color (mostly, it will be white on white).

## Text tag syntax

The text tag is a text element wrapped in {{  }}, tags must begin with {{ and end with }}. The tag data is separated by a pipe "|" symbol.

The first section of the syntax defines the field type such as signature or text, the second section indicates the signer index to which the field must be assigned, and the third section specifies whether the field is required or optional for the signer. The remaining two sections in the text tags are designated for optional fields: placeholder text and field ID.
The supported fields type can be placed in the document, which is a required tag.

**Syntax and Example**

```json
 {{*Field type*|*Signer Index*|*Required*|*Field label*|*Field ID*}}
 Ex:
 {{text|1|*|Enter name|field_1}}
```

 {% nestedtable %}

- {% arguments name="Field type" /%}{% required /%}
- Field type can be text, sign, init, etc.

---

- {% arguments name="Signer Index" /%}{% required /%}
- The index of signers to which the form fields should be assigned to the signers.

---

- {% arguments name="Required" /%}
- Whether this is required or not.

---

- {% arguments name="Field label"  /%}
- This will be displayed as the placeholder for text fields.

---

- {% arguments name="Field ID" /%}
- This will be the field identifier. Supported characters: A-Z, a-z, 0-9, hyphen, and underscore.

---

- {% arguments name="isReadOnly" /%}{% batch datatype="boolean" /%}
- Determines whether the form field is read-only.

{% /nestedtable %}

### Asynchronous processing

The text tags are supported in both document and template process. Please refer the following section to know more about how the document/template are processed

- {% customlink href="/documents/send-document/#asynchronous-document-processing" text="Document Asynchronous processing" /%}
- {% customlink href="/template/create-template/#asynchronous-template-processing" text="Template Asynchronous processing" /%}

### Document / Template not found

Learn more about document/template not found in the following section:

- {% customlink href="/documents/send-document/#document-not-found" text="Document not found" /%}
- {% customlink href="/template/create-template/#template-not-found" text="Template not found" /%}