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


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.qommentary.com/qommentary-writeback/custom-data/adding-input-columns/text.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
