Minimum quantity, maximum quantity, and increment settings from Product Quantity Rules and Quantity Limits by Product are automatically reflected in the quantity input field (quantity picker) on the product page. This lets customers see the quantity they can purchase before completing their order.
Quantity picker reflection works by the app sending a signal to the theme's quantity input field saying "please use this minimum, maximum, and increment value." Whether that signal is actually reflected in the quantity picker depends on the implementation of your Shopify theme. Some themes may not reflect the signal, but in that case no error is shown, and it does not affect the quantity-limit check performed at checkout.
Item | Description |
|---|---|
Initial value | Adjusts the quantity field's initial value to match the minimum quantity (or increment) |
Maximum | Limits the upper bound you can enter to the maximum quantity (it cannot be increased beyond this) |
Minimum | Limits the lower bound you can enter to the minimum quantity |
Increment | Matches the +/- button or spinner step to the increment |
The Applicability setting on a Product Quantity Rule changes what gets reflected in the quantity picker. Levels other than Variant are judged by a combined total across multiple products or variants, which a single quantity input field cannot accurately represent.
Applicability | Quantity Picker Reflection |
|---|---|
Variant | Reflects minimum quantity, maximum quantity, and increment |
Product | Reflects only the maximum quantity (minimum quantity and increment are not reflected) |
Cart | Reflects only the maximum quantity (minimum quantity and increment are not reflected) |
For Product- and Cart-level applicability, whether the minimum quantity or increment is satisfied is judged by combining multiple products or variants, so it can't be represented by the quantity picker alone. Even in this case, the check itself is performed correctly at checkout, so we recommend using the product message or alert message to communicate the purchase conditions to customers.
For more on Applicability, see the "Applicability (Product Quantity Rule)" page.
For Quantity Limits by Product, you can configure a "① Quantity Limit (per variant)" and a "② Total Quantity Limit (combined across variants)," but they are reflected differently in the quantity picker.
Setting | Quantity Picker Reflection |
|---|---|
① Quantity Limit (per variant) | Reflects minimum quantity, maximum quantity, and increment |
② Total Quantity Limit | Reflects only the maximum quantity. Whichever is smaller between this and ①'s maximum quantity is used (minimum quantity and increment are not reflected) |
Example: If ①'s maximum quantity is 10 and ②'s maximum quantity is 5, the quantity picker's upper limit is 5. Conversely, if ① is 3 and ② is 8, the upper limit is 3.
For more on Quantity Limits by Product settings, see the "Quantity Limits by Product: Settings" page.
Quantity picker reflection and the product message work together, not as alternatives to each other. The product message communicates purchase conditions in text, while quantity picker reflection restricts the input field itself. Combining both makes the purchase conditions clearer to customers.
Quantity picker reflection works by the app sending a signal to the theme. Depending on the theme's implementation, the signal may not be reflected. In that case, no error is shown, and the product message, alert message, and checkout-time limit check continue to work as normal.
Quantity picker reflection is only a reference before purchase. Whether an order can actually be completed is ultimately determined by the limit check performed at checkout.
For the behavior of the quantity picker when a collection set as an eligible item contains only some of a product's variants, also see the note under "③ Eligible items" on the "Product Quantity Rules: Settings" page.