# Number

The **Number** option type allows customers to enter a numerical value. This is useful for inputs that require quantities, measurements, or any other numerical data. The field only accepts numbers and can include settings for minimum and maximum values to ensure that inputs fall within a specified range.

👉You can check out our [Demo product](https://avis-demo.avisplus.io/products/unlimited-options) to see how it works

***

## **Basic option settings:**

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

#### **1. Option Name**

This is the internal label used to identify the Number option within the app’s settings. It helps you manage and organize the option but does not appear on the storefront product page.

#### **2. Label on Product**

This is the text displayed above the Number input field on the product page of your storefront. It provides customers with instructions or context for what they should enter, such as "Enter quantity" or "Specify amount."

#### **3. Label on Cart**

This is the text that appears on the Cart summary screen, Checkout, and Order detail page, alongside the customer’s numerical input. It helps identify and display the specific value entered by the customer, such as "Quantity: 5" or "Measurement: 10 cm."

#### **4. Required Field**

Determines whether the Number field must be filled out by the customer before they can complete their purchase. If enabled, the customer is required to provide a numerical input.

#### **5. Hide "Label on Product"**

Allows you to hide the label text that usually appears above the Number field on the product page. This can be used to simplify the interface if the label is not necessary.

#### **6. Min/Max Value**

These settings define the minimum and maximum numerical values that can be entered into the Number field. For example, you can set a minimum value of 1 and a maximum value of 100 to ensure inputs are within a specific range.

#### **7. Add-On Product**

This feature allows you to apply an additional charge based on the numerical input entered by the customer. For example, if a customer enters a quantity of 3, a predefined extra charge can be automatically added to the product’s price based on the quantity specified.

#### **8. Conditional Logic**

This feature enables you to set rules for when the Number field should be shown or hidden based on other customer selections. For example, you might configure the Number field to appear only if the customer selects a specific option or if certain criteria are met.

#### **9.** One time charge

This setting allows you to modify how additional charges are applied to a specific option value. Normally, the extra charge for an option is multiplied by the quantity of the product purchased (e.g., an additional charge of $10 would become $50 if the quantity is 5). However, by enabling the "One time charge" feature, the extra charge will only be added once, regardless of the product quantity. This is useful when you want to apply a flat fee for certain options without scaling the charge with the number of items purchased.

{% hint style="info" %}
[How to set up Conditional logic for your options](https://options-docs-v2.avisplus.io/app-features/conditional-logic-option-b-shows-if-option-a-is-selected)
{% endhint %}

***

## **Advanced option settings:**

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

#### **1. Default Value**

The pre-filled numerical value that appears in the Number field by default. It can be used to suggest a typical value or set an initial quantity, which customers can modify.

#### **2. Placeholder Text**

The text displayed within the Number field before the customer enters any value. It can provide an example or prompt, such as "Enter quantity" or "Specify measurement."

**3. Price display type**

Decide whether to **show or hide** the additional price on the slider interface.

#### **4. Class Name**

Allows you to assign a custom CSS class to the Number field. This helps apply specific styles or behaviors to the field based on your design preferences.

#### **5. Tooltip**

This setting allows you to provide additional information in a pop-up message when the customer hovers over the information icon. It provides brief, contextual information without cluttering the interface.

#### **6. Help Text**

This setting displays directly beneath the Text option, offering more detailed explanations or instructions. It remains visible as users interact with the form, providing ongoing support and clarity.


---

# 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://options-docs-v2.avisplus.io/option-types/all-option-types/number.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.
