Quantity
The Quantity element lets users enter or select a purchase quantity. It is typically used together with Product. Quantity is automatically linked to a specified Product field and, combined with Total, calculates the order total.
Basic
Label (required)
The label text displayed above or beside the quantity field (depending on the Label position setting).
Unique Name (required)
Identifies this form element internally within the system. The name is auto-generated by default; you can also modify it manually as needed. Naming rules:
- May only contain lowercase letters, numbers, and underscores
- Must start with a letter
Link to Product
Select a Product field from the dropdown to link it (placeholder prompt: "Select a product field").
Product linking
Quantity must be linked to a Product field to work properly. Once linked, the system automatically calculates the total in Total from the price of the user-selected product and the entered quantity (Product price × Quantity).
Input Type
The way the user enters the quantity. Available options:
- Number Input: Number input box; the user enters a number directly (default)
- Dropdown Select: Dropdown selection; the user selects from a preset quantity list
- Fixed Quantity: Fixed quantity; the quantity is set by the administrator and cannot be modified by the user
Input type selection suggestions
- Number Input: Best when users can freely enter quantities (default)
- Dropdown Select: Best when selectable quantities are limited (e.g., only 1/2/5/10)
- Fixed Quantity: Best for fixed-quantity packages (e.g., always buy a fixed 3 items)
Min Value
The minimum quantity the user can enter (default 1).
Max Value
The maximum quantity the user can enter (default 99).
Quantity limit suggestions
Set a reasonable quantity range based on actual inventory and sales strategy. For example, set Min Value to 1 and Max Value to 10 to limit the user to 1-10 items per order.
Styles
Label position
The display position of the label. Available options:
- Inherit: Uses the global configuration in Form style settings
- Vertical: The label appears above the quantity box
- Horizontal: The label appears to the left of the quantity box
- Hidden: The label is hidden
Data
Show in email
Whether this field appears in the email notifications (enabled by default). When disabled, this field is excluded from the submission email.
Advanced
Unique ID
The element's unique ID, auto-generated by the system, read-only and not editable.
Using e-commerce elements together
Quantity is typically used together with the following elements:
| Element | Purpose |
|---|---|
| Product | User selects a product (Quantity is linked via Link to Product) |
| Quantity | User enters the purchase quantity |
| Total | Automatically calculates the total (Product price × Quantity) |
| Shipping | Shipping method and shipping fee |
Calculation logic
Total = Product price × Quantity + Shipping fee (if any). Make sure Quantity is correctly linked to the Product field via Link to Product, otherwise Total cannot be calculated correctly.