# Text

**Text** controls are ideal for capturing any type of content - from short comments/notes to lengthy narratives.

**Data type**: `string`

### Adding a Text control

1\. Edit your sheet\
2\. Click on the **Qommentary Form** extension\
3\. Expand **Input fields** section\
4\. Click on **Add input field**

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FIe4JTbe5BvvH9IqJCfnA%2Fimage.png?alt=media\&token=23b2cd16-6a38-48c3-8fca-0177184bdf4d)

5\. Select **Text** from the dropdown menu

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FWWbOkJ9WmMuBK0lA91Mg%2Fimage.png?alt=media\&token=d57a9afb-0bdc-43e6-ac35-854855c393ec)

6\. Add a **label** to display in the form

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FT886u9TwRnedcHWRNFGs%2Fimage.png?alt=media\&token=5dfc8a94-f2fd-4572-a2bf-38e04f2bb58f)

7\. Add a **field** name

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FFyuXEGNBCWkNSJESmIOJ%2Fimage.png?alt=media\&token=0ec3a82c-5fa1-4ece-a718-9d816d119c5b)

{% hint style="danger" %}
If database is selected as data connection, then field name **must map** to destination table column name.
{% endhint %}

{% hint style="warning" %}
Field name cannot contain spaces.
{% endhint %}

8\. Click on **Done**

**Text** input field can now be updated and saved.

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FFrPaGRtmTYTSIkqX41su%2Fimage.png?alt=media\&token=6851dcfa-ce4d-43b6-8bb7-32bb370f658e)

### Enabling multi-line text

By default, the Text control displays values in a single line. When multi-line is enabled, users have a larger area to compose their narrative text before saving.

To enable multi-line text, please follow these steps:

1\. Edit your sheet\
2\. Click on the **Qommentary Form** extension\
3\. Expand **Input fields** section and **Text** control\
4\. Locate the **Text format** property

<div align="left"><img src="https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M43RhGzV8Plu0tfknia%2F-MZDJXBPujnEslrwotv6%2F-MZD_XVkoDAAZYiMNUP_%2Fimage.png?alt=media&#x26;token=71d14feb-e973-48b0-99c1-3b7173f32ba4" alt=""></div>

5\. Click on **Multi-line** button

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FuM0gCrSQ0ViiNrIqtklu%2Fimage.png?alt=media\&token=32fdcfba-8dc6-481b-bb4d-3d9f4e1d3b06)

6\. Drag and drop the slider handle to set the desired number of text lines to display in the textarea

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FxIltVBKNCcMgL7jMK9BL%2Fimage.png?alt=media\&token=56534ff8-1626-41ab-ad96-66fbd4c3a390)

### Setting a max limit

If you wish to set a limit to the maximum amount of characters that can be typed, please follow these steps:

1\. Edit your sheet\
2\. Click on the **Qommentary Form** extension\
3\. Expand **Input fields** section and **Text** control\
4\. Locate the **Max characters** property

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FT7vRMxOjHk8K9gfLlksb%2Fimage.png?alt=media\&token=4fc8d4ce-dcc5-40ca-a141-f60e878c196c)

5\. Change the max characters to your desired limit

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FlEpTf3ljJIM5PKW0tc4t%2Fimage.png?alt=media\&token=f594b1f5-9721-4649-b559-e50ab746c32b)