# Number Field

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

The Number Field option displays numeric data - such as product dimensions, or custom options like "engraving characters”.&#x20;

> 📝Note: Customers can only fill in numbers in the Number Field.

Example of how it appears on a product page:

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

### 2. How to Create a Number Field 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 > Number Field to create a new option

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

**Step 2: Add information to the Number Field**

* Enter the name for the Number Field (e.g., “Number of additional gift boxes", "Grade")

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcGA-oF2VjTG5mbCS9_AAGmDhg8KcSsJP65iNJg8h5fJm-nag_CtzehTDvbrV_ubvpmEX79jhUkzkptCQFuOSyCgFazf6fdW-9sCVUw20f0Dr-UnFNvlePILIB1kj0A9fC9MAGT?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

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

* Price Add-on feature will help you add extra fee for options customers choose.

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcD6n_Enh3_vhbOZUWM_D9V3iNdDqmyqUI4zwDEMh4dX6V0rIR59sTbfCa4FXHVuvVlnJYRwrBuIt-OvPRmdlDC6H3zZ_H9Ka_rxZ00mUd6kOMWg_gsUjJkyikd0PrBM_LVoIhJ7g?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_4nXddjK_ETWCwdYbeRxYC0AO1sVoTCkszkLwksKa4BVn0Ekaimz6i60zni6mVeVaNZtomMXRR5r_YFHBhMM9C4uFOFHCoWazud2QuU_wvdO0ESvfZtllepjPQSMdof6qnpNxQx_8WzA?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/gnrabDlrtho4JicGyuZS" 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 Number Field 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 “Year” Number field appears only if the customer selects “Yes” for “Are you a student?”

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

{% hint style="success" %}
**Help text**: Add a short description to explain the purpose of the Number Field 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 Number Field 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 “Number of additional gift boxes” will display automatically the number 2 in the field when customers go to the product page.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfmohsuIYHC2DE5JQ-T1wbS5iev2u6hlfzF-0KiXCxS1mO8o6sWDSBXkcWvGY9hqXt78ROYriBfUW7qvsMQGZs_k0pGmhGTilApKeHXJuvyMOvYqg-zgmHquAqjqvYQvSzKty-tJA?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

How it looks like in your storefront:

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

{% hint style="success" %}
**Placeholder text:** Display placeholder text inside the Number Field 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_4nXelWOX4buLMKbvL2Evm6-CVVxB7-X5JfMfDoHM90XhWExzikjL-40bnHGzwOt1A1l_QSrIbSYhLQFC7ZTWZYqF5VQ_euDHEzIzbsnA9wlgJyjBrSzGWdp6hU7ps7WuYbQIgdLu8Cg?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

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

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

{% hint style="success" %}
**Limit value:** You can set Min/Max value that customers can input.
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfNiqzbyh-vH5vkwtVkyUbg7Yh3OfB7xvonetWcDJS6iYCcprNzHZNAesFXbJ3UgpXHY-Ipnxtrcs8IpjDXmpNJch-zJeZ2I5a-c-4KVBlezALk1LeCVSovXsUT8o79jIVp--c5cQ?key=DC83dM0yOWsDjpoRFQoUWeuE" 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="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeVMyuvEJTTDd45t4NEpwlXEo1yOP696L0VwM8Za7Xu_hS_BXLHCc1G8Wn1pYhbaXwwSU6XCIXg1OicnbfbVbOZXtKYWceYGJ1hH_0aYeL4aYjAZr8WaVanWVAHprtG8x-vQ8Jpog?key=DC83dM0yOWsDjpoRFQoUWeuE" 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 Number Field works correctly.

### 3. Real-World Applications of Number Field

* Fashion & Accessories: Enter number of characters for engraving, jersey numbers, or custom sizing.
* Food & Catering: Specify number of guests, servings, or meal portions.
* Tech & Electronics: Show battery life, storage size, or power capacity as numeric data.
* Home & Furniture: Display weight, dimensions, or quantity per box.

### 4. Key Features of Number Field

* The Number Field option type prevents invalid input like letters or symbols. They're ideal for quantities, measurements, or custom inputs.


---

# 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/number-field.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.
