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

# Text box

### 1. How Does the Text box Display? <a href="#id-2-1-how-does-the-text-area-display" id="id-2-1-how-does-the-text-area-display"></a>

The Textbox typically appears as a field where users can input information with any characters.

> 📝Note:
>
> * Once you choose this option type, your customers can insert any text but emojis.
> * Text Box option type does not allow your customers to Enter and write more than one paragraph.

Example of how it appears on a product page - *A Sweater with a Textbox “Your name”:*

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FscY89BPAGBuuyagJ4E6v%2Fimage.png?alt=media&amp;token=10e0987e-afa0-4d21-b62f-44ba8b7abe56" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXexUUHjcjjFHzoIHH0ES_SeZBfmceY_jNbBG3hn5cWs3lYUqncJoord572NAwx1b9oxVOk9-ObKCPmD11QiBnI5wGmSB8o1Dmmp4xvyTtytDJRIPUmMmwK-zuelg9BoGlpMLoBu?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

### 2. How to Create a Text Box option <a href="#id-2-2-how-to-create-a-text-area-option" id="id-2-2-how-to-create-a-text-area-option"></a>

**Step 1: Add a New Option**

* Open **1. Add options**, click **Add option**, tick **Text box** under **Text input** on the **New options** tab, then click **Add options**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnGaqznnR0Koevt5envVQ%2Fimage.png?alt=media&amp;token=9e4c27b9-7b1c-4103-bfb6-07eb4181ac6f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIMGJIVd8CeBNp519dXGX%2Fimage.png?alt=media&amp;token=2485a906-fba2-4ed4-898a-697051f3621b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdoVpGFPK8r9a0bNLuNoS1UNQiRGqVosFZ6RISccD6kgQvCBaZ5RTNwzkq_Y4_Z9Tv9yoGK8NQRq4m69bfj8-hXVXwyBVEg-NsmA3WTPVgLhBFSe-SI9dZE64dmk8CUG1Z7pVV2Rg?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

**Step 2: Add information to the Textbox**

* Enter the **Label on product** (e.g., "Input your name", "Note"). Use **Label on cart** if the cart and order should show a different name. Tick **Required field** if customers must fill it in, or **Hide option label** to hide the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCDKTzXfZiiWSGuiFgSTg%2Fimage.png?alt=media&amp;token=d24efc17-c4ae-42c3-9102-45aec276f32e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdLD2acAupsJxFfTrZFBQKoJW4ZkViiYmN_KIRTh1yS4H0CrWr5hWdNPVfEhwhB3WO9F77YqKYWQOzdp7oac639sXB5XEXg757PfWr2b2amhk1u53UvXbudQaxX-e_z5I9VoCWHqA?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

**Step 3: Set the target of Price add-on in Option values (optional)**

{% hint style="info" %}
Price Add-on feature will help you add extra fee for options customer choose
{% endhint %}

* If you choose **Extra fee**, see details of this feature in [How to add price to options?](/product-options/advanced-setup/other-popular-features/manage-add-on-additional-fee-for-option.md).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdD3AXyj1RXRbLRfA2rHv%2Fimage.png?alt=media&amp;token=b4d523fb-5558-49be-8aac-eb57d4fd2721" alt=""><figcaption></figcaption></figure>

How the Price add-on will look on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLaCXYprKy0prT4HINspP%2Fimage.png?alt=media&amp;token=ede154b1-a92b-4faf-80e4-10adea6e2fc7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeX3qb05QTcEmrRqFt55bC0DsNJfEVKzJ_rK0bNsSFRzqyyHyqrprGRk-rlc0vL_lKMHdUtOAIcSs7dBO_ydiNBotniusPLSUDmM_Ft4YILO-lgigYlwL9bzxjwNoNHhliZFib8uA?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

* If you choose to Upsell product, follow [this guide](/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value.md) for more information.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNQEnillZKrOA5zEnGWuy%2FScreenshot%20(2).png?alt=media&amp;token=a5eda0b1-43d4-406d-b23e-a9a574b7c147" alt=""><figcaption></figcaption></figure>

Other features:

* Price add-on > Extra fee – [What is it & How to Use](https://www.youtube.com/watch?v=5Bq4t0IrVEU)
* Price add-on > Upsell product – [What is it & How to Use](/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value.md)
* SKU – [What is it & How to Use](https://www.shopify.com/ca/retail/what-is-a-sku-number)
* Quantity – [What is it & How to Use](/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options.md)

**Step 4: Advanced Settings (If Needed)**

{% hint style="success" %}
**Visibility**: Enable visibility condition if you want the Text box to show/hide only when a customer selects a specific option from another field. [How to set up Visibility?](/product-options/advanced-setup/other-popular-features/how-to-set-up-conditional-logics.md)
{% endhint %}

Example: A “Input your name” Text box appears only if the customer selects “Yes” for “Would you like to personalize this item?”

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FoMJ1lw7yoh25TvvlQpRn%2Fimage.png?alt=media&amp;token=09e2d10d-ff45-4a8e-8466-d6dde5b6ed23" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Help text**: Add a short description to explain the purpose of the Text box option, offering context or clarification when the customer enters the information. Help text can be displayed as Tooltip or Content (Below/Beside the option title, Below the option).
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXftZZ1ZCCt5Yp-TCUnCC6PUPw3_Lg_zD8TvFeDWW4I5fdS7bHsbz8-WpKPJlSO2LrBIC1ygprRXJTXzZunrzboehthEjDhP61qYJJzVh5FQVYIRph5et5XuyNYkIDlrNTTDyOo6cg?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuZoETiaRK2wqRlA2I367%2Fimage.png?alt=media&amp;token=5e6c5bf1-a9cd-4ef1-8835-e42b4ce3eb74" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Default value**: Pre-fill text inside the Text box that appears every time the customer goes to the site. It can save time for customers by providing common or expected input.
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCECTDOawPxq0sC0C4LP6%2Fimage.png?alt=media&amp;token=f24b9780-7b12-4609-864a-942706bac90c" alt=""><figcaption></figcaption></figure>

Example: You want the option “Message” will display the text “Happy Birthday!” automatically in the field when customers go to the product page.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfPg5vpNyzd3Yo08-c6LjwSUk8Ur4mkG69AbqDYfxSlVTXXaGtC7S4Hk_g7KhTKhs-Tr3cabvBN1NPX14tkbflSAjlK5vEebxTnYfPlGCzpUw4GATW7Ser47vVbOLFhJ-6I3ij_lQ?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

How it looks like in your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F92WrhS87ArNcJNcG07iq%2FScreenshot%20-%202026-01-12T142138.473.png?alt=media&amp;token=b04ca98f-3d6e-4216-89c1-9179c58dc242" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Placeholder text:** Display placeholder text inside the Text box as a faded, lighter color. This text disappears when the customer starts typing and is often used to give customers a clear example of what should be filled in the field.
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdC8m3F5qPdD0qyeFOGqTOy95YIUccAdjQZ_jGY5Go24Im4AH3DJwnVGKtgCw4oAs9Idpwb7tApKZX9hn8hzRuaWnx3PYefFGGITRdL_KgXg3c-26qzVwn1vlvz6F68XcM-BHLdGQ?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGJ6QiiMObJHe7vVk4mAI%2Fimage.png?alt=media&amp;token=0117aa0b-facf-41c4-84ce-590c97b209b0" alt=""><figcaption></figcaption></figure>

Here is an example of how it looks like in your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7junpvfI8eabjUFvSkkC%2FScreenshot%20-%202026-01-12T143933.865.png?alt=media&amp;token=68782870-2072-4ea0-9be9-21dc4ccae2ff" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Limit characters:** Set **Min character** and **Max character** to limit how many characters customers can type in the Text box.
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQasiki9gWmsLt4E9AY1f%2FScreenshot%20-%202026-01-12T144027.912.png?alt=media&amp;token=b095b54f-2b70-4e91-84e9-650d4fcf07c6" alt=""><figcaption></figcaption></figure>

If a customer types fewer characters than the minimum, or more than the maximum, a notification message is shown below the field.

When a **Max character** is set, a counter such as **12/50 characters** appears under the field. You can turn this off in **Settings > General Settings > Option type setting > Text input > Character count for text box**. You can also change the wording of these messages in **Settings > Translation Texts > Default text customization > Product page**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fv26xkV4yR45PP29gh05C%2FScreenshot%20-%202026-01-12T144123.577.png?alt=media&amp;token=df8ae210-6121-4e1f-a8a5-2de76cd62cc1" alt=""><figcaption></figcaption></figure>

**Live mockup:** You can also use [**Product Personalizer – Live Mockup Settings**](/product-options/advanced-setup/other-popular-features/product-personalizer-live-mockup-settings.md) to display customers’ text directly on the product in real time. This allows customers to preview their personalized design before adding the product to the cart, helping them confirm the appearance and reduce potential order errors.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwAH65NnA2nmEDzlvlEpd%2Fimage.png?alt=media&amp;token=0418eb60-4546-4fb1-9e9d-0466f0bd293b" alt=""><figcaption></figcaption></figure>

**Step 4: Save and Test**

* Click Save to apply the settings.
* Visit the product page on your store to check if the Text box works correctly.

### 3. Real-World Applications of Text box

* Product Customization: Customers can enter personalized text for items like custom engravings or messages (e.g., personalized gifts).
* Forms: Collects customer details like name, shipping address, and payment information (e.g., entering shipping address at checkout).
* Order Notes: Allows customers to add comments or special requests to their order.

### 4. Key Features of Textboxes

* Textboxes allow users to input information efficiently, reducing errors with placeholder or help text. They're versatile for short or long entries, easy to use on mobile, and essential for customization, forms, and feedback.
