> For the complete documentation index, see [llms.txt](https://knowledgebase.qommentary.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.qommentary.com/qommentary-writeback/custom-data/adding-input-columns/text.md).

# 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 Writeback** extension\
3\. Expand **Input Column** section\
4\. Click on **Add column**

<div align="left"><img src="/files/-MZCx6ezSPuMpGDkleyH" alt=""></div>

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

<div align="left"><img src="/files/-MZCzQxLm0qri0ZeEmpB" alt=""></div>

6\. Add a **label** to be displayed as a column header

<div align="left"><img src="/files/-MZD0d4MuDZhlOxmpczs" alt=""></div>

7\. Add a **field** name

<div align="left"><img src="/files/-MZD0qIq01H1TeXz-JxX" alt=""></div>

{% 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 column can now be updated and saved.

![](/files/-MZD1Y2YHnQeDY44vDwJ)

### 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 Writeback** extension\
3\. Expand **Input Column** section and **Text** control\
4\. Locate the **Text format** property

<div align="left"><img src="/files/-MZD_XVkoDAAZYiMNUP_" alt=""></div>

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

<div align="left"><img src="/files/-MZD_yNPX4VnJCHeeXmZ" alt=""></div>

6\. Select an appropriate **Text input size** which will determine the textarea width

<div align="left"><img src="/files/-MZDaTxshENmPkEIcORM" alt=""></div>

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

<div align="left"><img src="/files/-MZDasV0ZfRP3q3WOGHp" alt=""></div>

8\. Set the number of lines which should be visible on the table cell before overflowing content is clipped

<div align="left"><img src="/files/-MZDbFWITWEtkwLz1W-e" alt=""></div>

### Adding multi-line text

To add multi-line text to your table, please follow these steps:

1\. Load your sheet with a **Qommentary Writeback** extension\
2\. Click on a **Text** control. A textarea will popup.

![](/files/-MZDdEGmZMNy_fZjNoM_)

3\. Start typing your text and click on the **green tick** icon

![](/files/-MZDdkR3ky6dJiUihC7H)

{% hint style="success" %}
Text control is updated with new content
{% endhint %}

![](/files/-MZDe-F1Dk1-JHIeM6Ft)

### 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 Writeback** extension\
3\. Expand **Input Column** section and **Text** control\
4\. Locate the **Max length** property

<div align="left"><img src="/files/-MZDemrNA6NkrbYiJX7j" alt=""></div>

5\. Change the max length to your desired limit

<div align="left"><img src="/files/-MZDfGlLdlix_zzgvzeT" alt=""></div>

### Customizing column width

Input columns have a set width by default. If you wish to change the column width, please follow these steps:

1\. Edit your sheet\
2\. Click on the **Qommentary Writeback** extension\
3\. Expand **Input Column** section\
4\. Locate the **Column width** property

<div align="left"><img src="/files/-MZDMKp4nLaBy5IYUHON" alt=""></div>

5\. Drag the slider to adjust the column width

<div align="left"><img src="/files/-MZAAMpAXfEWAmU2bfz4" alt=""></div>

4\. Alternatively, you can enter a specific value in the **Custom column width** field

<div align="left"><img src="/files/-MZAAZ3qrMZoe0U7VUxs" alt=""></div>
