# 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://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**

* Click Add Option > Text box to create a new option

<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 name for the Textbox (e.g., "Input your name", "Note")

<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 %}

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

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

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

<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](https://optis-options-helpdesk.crisp.help/en/article/how-to-use-assign-to-variant-link-stock-and-price-of-shopify-variant-to-option-value-1u73u86/) for more information.

<figure><img src="/files/5zwiYMxcD3BQWGyQIGKe" alt=""><figcaption></figcaption></figure>

Other features:

* Price Add-On > Create Fee – [What is it & How to Use](https://www.youtube.com/watch?v=5Bq4t0IrVEU)
* Price Upsell product > Assign to Variant – [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" %}
**Conditional Logic**: Enable conditional logic if you want the Text box to show/hide only when a customer selects a specific option from another field. [How to set up Conditional logics?](https://optis-options-helpdesk.crisp.help/en/article/how-to-set-up-conditional-logics-1dgigop/)
{% 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="/files/KP5wnDtwimTzPSNkRBbj" 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>

{% 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 %}

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="/files/osk3zl5Si2vvS0Kj2TuX" 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>

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

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

{% hint style="success" %}
Limit characters: You can set Min/Max characters that customers can input in the Text box.
{% endhint %}

<figure><img src="/files/6e1sttLM9sifg2Auuviw" alt=""><figcaption></figcaption></figure>

If your customers input less than the minimum value, it will show a notification message below. The same with maximum value.

<figure><img src="/files/gq7wWhPka7j45zJF24k5" 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.


---

# 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.optis.me/product-options/18-option-types/text-input/text-box.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.
