# Textarea

## **Element Description**

The **Textarea** field is used for collecting longer inputs from users, such as addresses, detailed instructions, or comments. It allows multi-line text, offering flexibility in gathering extended information compared to a standard text field.

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

### **Sample Use Cases**

* Collect shipping or billing addresses from customers.
* Request additional order instructions or comments.
* Provide a space for feedback or special requests from customers.

<figure><img src="/files/vJ2U4GWYiuVcQRYUR1vq" alt=""><figcaption><p>Text Area</p></figcaption></figure>

## **Textarea** Field Settings

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

* **Label** – The name of the field displayed to the customer on the checkout page.
* **Placeholder** – The text that appears inside the input box before the customer types anything.
* **Description** – Additional information or instructions about the field, are displayed below the input box.
* **Enable/Disable Field** – Allows you to enable or disable the field based on your needs. If it is disabled, the element will not be displayed in the checkout form, you can enable it anytime from the checkout builder according to your needs.
* **Is Required** – If enabled, the customer must fill in this field before proceeding with checkout.
* **Default Value** – The pre-filled value that will appear in the field when the page loads.
* **Max Length** – The maximum number of characters that the customer can enter in this field.
* **Rows** – Determines the visible height of the text area by specifying the number of rows. This can be adjusted based on how much space you expect the customer to need for input.

**Advanced Settings**

* **Custom Class Name** – Add [**custom CSS classes** ](/checkout-custom-fields-builder-for-woocommerce/plugin-features/custom-classes.md)to the field for styling or functionality.
* **Allowed Characters (Regex)** – Set a regular expression to define allowed characters that can be input into this field.
* **Error Message** – Customize the error message that appears if the validation for the field fails.


---

# 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.stylemixthemes.com/checkout-custom-fields-builder-for-woocommerce/checkout-builder-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.