Number Input

The Number Input field allows customers to enter a numeric value. This field is commonly used for measurements, quantities, or custom amounts and can directly affect the final price of the product. The entered value can be used immediately in calculations or referenced in later steps of the calculator.

Label

The Label defines the text displayed above the input field on the product page.Use a clear and descriptive label so customers know which number they need to enter.

Example: Width (cm)

Placeholder

The Placeholder is a hint or example shown inside the input field before the customer enters a value.This helps clarify the expected format or unit.

Example: e.g. 120

Key (unique ID)

The Key is a unique technical identifier for this field.It is used by the calculator engine and can be referenced in pricing formulas or conditional logic.

Important rules:

• Only lowercase letters are allowed

• Numbers and underscores are supported

• No spaces or special characters

Examples: width_cm · custom_quantity

Required field

When Required field is enabled, the customer must enter a value before the product can be added to the cart.Use this option when the number is essential for calculating the price or fulfilling the order.

Default value

The Default value pre-fills the input when the product page loads. The customer can still change it. Useful for sensible starting points (e.g. 1 for quantity, or a common width for sized products).

Is quantity input

When Is quantity input is enabled, the entered number is treated as the product quantity instead of a custom value.This means the value is linked to the Shopify cart line quantity and influences inventory and cart behavior.

Only one number field per calculator can act as the quantity input.

Allow negative values

The Allow negative values toggle controls whether the customer can type a number below zero.

• Enabled – negative numbers are accepted (useful for offsets, deltas, etc.).

• Disabled – the input is automatically clamped to 0 if a negative value is typed. The configured minimum still applies on top of that.

For most pricing inputs (length, quantity, surface area) you should leave this disabled.

Numeric value (float)

The Numeric value (float) defines the base numeric value used in calculations.This value is typically used as a multiplier or starting point when calculating prices based on the customer’s input.

Example use cases:

• Price per unit

• Price per square meter

• Price per item

Minimum

The Minimum value defines the lowest number the customer is allowed to enter.If the entered value is lower than the minimum, the input will be considered invalid and the product cannot be added to the cart.

Example: 10 (minimum width of 10 cm)

Maximum

The Maximum value defines the highest number the customer is allowed to enter.If the entered value exceeds this limit, the input will be considered invalid.

Example: 300 (maximum width of 300 cm)

💡 Tip:Always set a minimum and maximum when using Number Inputs for pricing calculations. This prevents invalid values and ensures accurate price calculations.