> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/options/option-types/input-types/textarea.md).

# Textarea

A multi-line field for gift messages and instructions, with the same settings as Text plus alignment, width, and height in the live preview.

A multi-line field. It has the same settings as [Text](/options/option-types/input-types/text.md), with room for line breaks.

Use it when the answer is a sentence or longer, such as a gift message, care instructions, a description of a repair, or a brief for a custom piece.

**Watch it done — 1:12.** A gift message box on the product page, with a character limit so the message fits the card you actually print.

{% embed url="<https://www.youtube.com/watch?v=YblF9fbxtSc>" %}

## What customers see

A taller field that accepts several lines, with your label above it and an optional character counter below.

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-6ac1ee9c71325eff5d2ca9f9e2b18df43e916fc0%2F2026-09-01_10-34-27.png?alt=media" alt="A multi-line textarea on a storefront product page with a gift message typed into it"><figcaption><p>A textarea gives customers room for a real message.</p></figcaption></figure>

## Settings

Textarea has exactly the same settings as [Text](/options/option-types/input-types/text.md), on both tabs:

<table><thead><tr><th width="240">Tab</th><th>Settings</th></tr></thead><tbody><tr><td><strong>Basic</strong></td><td><a href="/options/option-types/shared-settings/labels-and-visibility.md#label">Label</a>, <a href="/options/option-types/shared-settings/labels-and-visibility.md#name">Name</a>, <a href="/options/option-types/shared-settings/required-and-default-value.md#required-field">Required field</a>, <a href="/options/option-types/shared-settings/labels-and-visibility.md#hidden-label">Hidden label</a>, <a href="/options/option-types/shared-settings/limits.md#min-and-max-character">Min character</a> and <a href="/options/option-types/shared-settings/limits.md#min-and-max-character">Max character</a>, <a href="/options/option-types/shared-settings/placeholder-and-help-text.md#placeholder">Placeholder</a>, <a href="/options/option-types/shared-settings/placeholder-and-help-text.md#help-text">Help text</a>, <a href="/options/option-types/shared-settings/required-and-default-value.md#default-value">Default value</a>, <a href="/options/option-types/shared-settings/limits.md#character-counter">Character counter</a>, <a href="/options/option-types/shared-settings/conditional-logic-and-add-on-fields.md#price">Price</a>, <a href="/options/option-types/shared-settings/conditional-logic-and-add-on-fields.md#conditional-logic">Conditional logic</a></td></tr><tr><td><strong>Advanced</strong></td><td><a href="/options/option-types/shared-settings/conditional-logic-and-add-on-fields.md#add-on-quantity">Add-on quantity</a> and <a href="/options/option-types/shared-settings/conditional-logic-and-add-on-fields.md#quantity">Quantity</a>, <a href="/options/option-types/shared-settings/text-input-rules.md#allowed-value">Allowed value</a>, <a href="/options/option-types/shared-settings/text-input-rules.md#text-transform">Text transform</a>, <a href="/options/option-types/shared-settings/placeholder-and-help-text.md#help-text-position">Help text position</a>, <a href="/options/option-types/shared-settings/prefix-suffix-and-icons.md#suffix">Suffix</a>, <a href="/options/option-types/shared-settings/prefix-suffix-and-icons.md#prefix">Prefix</a>, <a href="/options/option-types/shared-settings/direction-width-and-css.md#html-class">HTML class</a>, <a href="/options/option-types/shared-settings/direction-width-and-css.md#column-width">Column width</a></td></tr></tbody></table>

## Personalizer

Text and Textarea behave differently in the live preview, because Text is a single line and Textarea is a block.

<table><thead><tr><th width="250">Personalizer setting</th><th width="130">Text</th><th>Textarea</th></tr></thead><tbody><tr><td>Text color, Font size, Font style, Font family</td><td>Yes</td><td>Yes</td></tr><tr><td><strong>Text alignment</strong></td><td>No</td><td><strong>Yes</strong> — left, centre, or right</td></tr><tr><td><strong>Width</strong> and <strong>Height</strong></td><td>No</td><td><strong>Yes</strong> — the block the text wraps inside</td></tr><tr><td><strong>Curve</strong></td><td><strong>Yes</strong></td><td>No</td></tr><tr><td><strong>Auto-fit max width</strong></td><td><strong>Yes</strong></td><td>No</td></tr><tr><td>Position, opacity, rotation</td><td>Yes</td><td>Yes</td></tr><tr><td>Text effects</td><td>Yes</td><td>Yes</td></tr><tr><td>Crop area, customer controls</td><td>Yes</td><td>Yes</td></tr></tbody></table>

A Textarea layer is a block that you size and align, and the customer's lines wrap inside it. A Text layer is a single line that you can bend along a curve.

See [Text layers](/options/product-personalizer/layer-settings/text-layers.md) and [Position, size, and rotation](/options/product-personalizer/layer-settings/position-size-rotation.md).

## Add-on pricing

Add-on pricing works the same way as on Text, including the **Per character** mode. Customers usually enter more text in a Textarea, so a per-character charge can become large. Set a **Max character** value to limit it.

For a gift message, use no charge or a single flat fee. See [Advanced add-on modes](/options/add-on-pricing/advanced-add-on-modes.md).

## Examples

**Gift message, free**

<table><thead><tr><th width="270">Setting</th><th>Value</th></tr></thead><tbody><tr><td>Label / Name</td><td><code>Gift message</code></td></tr><tr><td>Max character</td><td><code>200</code></td></tr><tr><td>Character counter</td><td><strong>Show</strong></td></tr><tr><td>Placeholder</td><td><code>Happy birthday, from all of us</code></td></tr><tr><td>Price</td><td>None</td></tr><tr><td>Conditional logic</td><td>Show when <strong>Gift wrap</strong> is selected</td></tr></tbody></table>

**Brief for a custom commission**

Min character `50`, max character `1000`, **Required field** on, help text `Tell us about the piece you have in mind. Two or three sentences is enough.`

**Printed poem on a print**

Max character `400`, **Personalizer** on, **Text alignment** set to center, and **Width** and **Height** matching the printable area.

## Notes

* Available on all plans.
* Works in Shopify POS.
* Line breaks are preserved and travel through to the order.
* A long entry is accepted on the order but may not fit your printing area. Set **Max character** to what you can produce.
* **Allowed value** and **Text transform** apply to the whole entry, including across line breaks.
