Quantity Block
The Quantity block lets customers adjust quantity inside a product form. It is usually rendered as part of the Buy buttons stack.
How It Works
The quantity selector follows the currently selected variant. When Shopify provides quantity rules, the selector respects minimum, maximum, and increment requirements. When the product form is disabled, the quantity selector is removed from the interaction path.
Merchant Setup
- Keep the Quantity block inside the Buy buttons stack unless you have a specific product form layout reason to separate it.
- Confirm products with quantity rules have the correct minimum, maximum, and increment values in Shopify Admin.
- Test the selected variant after changing variant options because quantity rules can vary by variant.
- Confirm mobile layout leaves enough room around the stepper controls.
QA Checklist
| State | What to confirm |
|---|---|
| Standard product | Quantity starts at 1 and updates before add-to-cart. |
| Minimum quantity | Quantity starts at the variant minimum when Shopify defines one. |
| Increment rule | Stepper changes follow the configured increment. |
| Maximum quantity | Quantity cannot exceed the configured maximum. |
| Unavailable variant | Quantity controls do not invite a purchase that cannot be completed. |