Some settings from product quantity rules, quantity limits by product, or cumulative quantity rules can be reflected in the quantity picker on the product form. For variant-level limits, the minimum quantity, maximum quantity, and increment are reflected. For limits that combine multiple variants or products, only the maximum quantity is reflected.
Prerequisite: Enable the app embed in your main theme.
Setting | Reflected in the quantity picker |
|---|---|
Minimum quantity | If set, reflected in the default value and the min attribute |
Maximum quantity | Reflected in the max attribute |
Increment | Reflected in the step attribute. Does not change the default value on its own |
Applicability | Reflected |
|---|---|
Variant | Reflected |
Product | Only the maximum quantity is reflected |
Cart | Only the maximum quantity is reflected |
With "Product" and "Cart", multiple variants or products are combined, so the minimum quantity and increment are not reflected. Only the maximum quantity is reflected in the quantity picker. At checkout, all conditions are evaluated according to the applicability you set.
Quantity limits by variant reflect the minimum quantity, maximum quantity, and increment. The total quantity limit for the product reflects only the maximum quantity.
Note: The quantity picker reflects the maximum quantity you set. Even if the cart already contains the same variant, the value is not reduced by that quantity. At checkout, the same variant in the cart is combined for evaluation.
For a cumulative quantity rule, only the rule's maximum quantity is reflected. The customer's remaining allowance is not.
Purchase totals trail the orders that produced them, so reflecting the remaining allowance could hold a customer below what they can still buy.
The remaining allowance can be shown in the product message instead.
The final evaluation, including the total, happens at checkout.
The maximum quantity is reflected for customers who are not logged in as well.
When a product quantity rule, quantity limits by product, and a cumulative quantity rule apply to the same variant, the quantity picker reflects the smaller of the applicable maximum quantities. At checkout, all of the limits must be satisfied.
If a cumulative quantity rule's maximum quantity is lower than a minimum quantity another limit applies, the cumulative maximum is not reflected in the quantity picker. An input whose minimum exceeds its maximum cannot be satisfied, so the evaluation is left to checkout.
Check whether the app embed is enabled
Check whether your theme supports reflecting settings in the quantity picker
Check the value you want reflected. The minimum quantity and increment only apply to variant-level limits
For cumulative quantity rules, only the maximum quantity is reflected
Note: Whether the quantity picker's attributes affect actual input behavior depends on how the Shopify theme is implemented. Even if the quantity picker cannot be controlled, quantity limits are still evaluated in the cart and at checkout, and an alert message is shown when a limit is violated. Whether the product message is shown also depends on the theme's product form structure.
When you target a collection that specifies products at the variant level, the limit applies only to the eligible variants in the cart and at checkout. However, the product message on the product form and the reflection in the quantity picker are applied at the product level.
Initial Setup (Product Quantity Limits)
Product Quantity Rules: Settings
Applicability (Product Quantity Rule)
Quantity Limits by Product: Settings
About Cumulative Quantity Rules