# Textarea

Textarea takes in simple user input as a string. It's usually used when you want the user to input a paragraph of text.

<figure><img src="/files/qaMi43rs7ngVK2sBPUSp" alt=""><figcaption></figcaption></figure>

## Properties

<figure><img src="/files/WWoBgmjsDdcNANY31Ejz" alt=""><figcaption></figcaption></figure>

**Form item name:** This is the name that the encompassing form will use to access the output of the checkbox. See [Custom Form](/app-builder/app-construction/elements/form-elements/custom-form.md) for how it's used.

**Input value:** The default value.

**Textarea rows:** The initial amount of rows for the textarea.

**Min length:** Minimum length of the text in the textarea.

**Max length:** Maximum length of the text in the textarea.

**Auto size:** Enable to let the textarea automatically expand to display more content.

**Show word limit**: Enable to show your Max length in the textarea.

**Textarea placeholder:** Placeholder when there is no text in the teaxtarea.

**Disabled:** Enable to disable the textarea.

See [Form Check](/app-builder/app-construction/elements/form-check.md) for data validation.

See [Tooltip](/app-builder/app-construction/elements/tooltip.md) for tooltip configurations.

## Supported Events

**Focus:** Triggered when a user selects the Textarea.

**Blur:** Triggered when a user deselects the Textarea (clicks outside).

**Value input:** Triggered when a user types in the Textarea.

**Value change:** Triggered when a user changes the value of the Textarea and either the Textarea is deselected or users press Enter.

**Press enter:** Triggered when users press Enter when in the Textarea.

## Supported Actions

**Set Value:** Set the value of the element.

**Set Validate Result:** Set whether the input is valid.

**Set Data:** Change element data. See [Data Store](/app-builder/app-construction/data-store.md).

**Set Loading:** Set loading animation. See [Set loading animations](/app-builder/popular-use-cases/set-loading-animations.md).

{% hint style="info" %}
Visit [Interactions](/app-builder/app-construction/interactions.md) for more on events and actions.
{% endhint %}


---

# 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://docs.acho.io/app-builder/app-construction/elements/form-elements/textarea.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.
