Letting customers choose quantities and bundle sets
The quantity selector in Bundlex Bundles adds a stepper to your offer cards so a shopper can choose how much they want without leaving the product page. Someone looking at a "Buy 3, save 15%" offer can set the quantity to 4 and get four items at the right price, in one add to cart.
This is the Bundlex Bundles stepper inside the widget. It's not the same as your theme's quantity box above the Add to cart button. For that one, see hiding the theme quantity selector.
Why use the Bundlex Bundles selector instead of the theme quantity box?
In the usual offer setup, the theme's quantity box navigates between your configured offers. It does not reliably mean "add this exact number" or "buy this many complete bundles". For example, with Buy 1 and Buy 3 offers, typing 2 into the theme box can still add the selected offer's quantity.
The Bundlex Bundles selector understands the offer: it counts individual items for quantity offers and complete sets for product bundles. When the app provides its selector, it automatically hides the theme quantity control. The hidden input stays synchronized for compatible purchase flows rather than acting as a second independent control.
Some stores have a support-enabled setup for exact quantities through the theme box on eligible plain quantity offers. That is not the default for every discount. See theme quantity selector behavior for details and hiding instructions.
Turn it on
- Open your bundle and go to the Add-ons tab.
- Switch on Quantity selector.
- Choose its position and, for Inside the offer, which eligible offers should show it.
- Save. Activate the discount if it is Draft, then test the storefront.
What the number means
It depends on the kind of offer, so that the number always matches how that offer is charged:
- Quantity offers (buy 2, buy 3, buy 5...): the number is how many items the customer buys. Setting it to 7 adds 7 items.
- Bundles: the number is how many complete bundles they buy. Setting it to 2 adds 2 bundles, each with all of its products and gifts.
- Plain "3 for $10" offers without gift or upsell extras: the number is how many whole deals they buy. Setting it to 2 adds 2 deals, so 6 items.
For example, you can show just one bundle offer containing a face cream and a serum. With the selector inside that offer, 1 means one cream and one serum; 2 means two creams and two serums. You do not need a separate offer card for each number of sets.
The discount follows the quantity
On quantity offers the stepper starts at that offer's own quantity, and the customer can go up from there one item at a time. When the quantity reaches another eligible tier with a stepper, the selection moves to it automatically. Going back down moves it back. A tier whose stepper is hidden can still affect pricing without becoming the selected card.
So with tiers of 1, 3 and 5, a customer who picks the single item and steps up to 3 lands on your "Buy 3" deal without having to notice it existed. The configured discount for the qualifying quantity applies.
Free gifts follow the offer rules
On quantity offers a free gift is added a single time, no matter how high the quantity goes. "Buy 5 or more and get a free gift" gives one gift at 5 items and one gift at 9. Bundles work the other way, because each bundle is a complete set: 2 bundles include 2 of everything, gifts included.
Choosing which offers show the stepper
With the quantity selector on, more than one offer configured and Position set to Inside the offer, a Show on: list appears with one checkbox per offer. Untick an offer and its card no longer shows a stepper - the card stays clickable as a fixed quantity.
A common setup is to tick only your last offer, so the first tiers are simple one-click choices and the last one is open ended: "Buy 5 or more" where the customer picks the exact amount.
Hiding a stepper only changes what the customer sees. It never changes what checkout charges: if the quantity passes a hidden tier, that tier's discount still applies.
One selector above or below the offers
By default each offer card has its own stepper. To show one quantity selector for the whole widget instead, set Position to Above the offers or Below the offers. It sits under the Quantity selector switch in the Add-ons tab. Inside the offer is the default.
The shopper steps the number up or down, and the widget selects the offer that quantity has earned. Clicking an offer sets the number to that offer's quantity. Prices and checkout work the same as with the stepper inside the cards. Only the place of the selector changes.
- Bundle offers, Fixed total price offers and offers with a free gift below your highest tier stay click-to-select. While one of them is selected, the selector hides.
- The Show on: list is hidden while the selector sits above or below.
- It works with Offer selection is optional.
Position is greyed out in two cases, and the dashboard shows which one applies:
- The discount still uses the older multiplier behavior (see "If your discount was created before August 2026" below). Switch Selector behavior first.
- The discount has no regular quantity offer, for example only bundles or only fixed total price offers.
Offers that don't get a stepper
Some offers show no stepper even when the setting is on. A gift or upsell quantity tier generally needs to be the unique highest threshold to support open quantities. Plain fixed-total-price offers count whole deals, while fixed-total-price offers with only gift or upsell extras do not get a stepper. The dashboard marks unavailable choices and explains the restriction.
Settings you can't combine it with
The quantity selector is not available in add-ons-only mode. It also can't be switched on while the discount uses any of these. The dashboard names the one that's blocking it:
- A gift selector anywhere in the discount.
- Limit discount to offer quantity.
- Count each variant separately.
- Any Buy X Get Y offer in the discount.
Each of these changes how quantities are counted or priced in a way the stepper would contradict, so they're mutually exclusive rather than merely discouraged.
Progressive gifts do work with it
Progressive gifts are compatible. Unlocks are checked against the chosen quantity, so raising it can unlock a gift. The gift quantity itself stays the same and doesn't multiply.
Subscriptions work with it too
You can use the quantity selector and Subscriptions in the same discount. The offer price and both the Subscribe and One-time prices follow the quantity the shopper picks, and the tier it reaches.
If the quantity reaches a tier priced with Fixed total price or Amount off per item, the subscribe option turns off, the same as when the shopper selects that offer directly. Stepping back down turns it on again.
If your discount already had subscriptions on before September 2026, the quantity selector stays off until you switch it on and save.
Add-on products have their own stepper
Products in the Upsell offer block have a separate Show quantity input option per product, using the same stepper. That one is independent of this setting and isn't affected by the restrictions above.
If your discount was created before August 2026
Older discounts that already had the quantity selector enabled kept the original multiplier behavior: on a "Buy 3" offer, picking 2 adds 6 items. Older discounts whose selector was disabled moved to the newer behavior, so creation date alone does not tell you which mode a discount uses.
To move a discount to the newer behavior, open it and use Selector behavior under the Quantity selector setting. Two things worth knowing before you do:
- The switch is one way. Once you save it, the old behavior is no longer offered.
- If your offer titles mention quantities, re-read them afterwards. "Buy 3" with the old behavior meant sets of three; with the new one the customer simply picks how many they want.
Discounts you create now already use the newer behavior, and show no such setting.
Before you turn it on
- Preview it. Use the editor preview to check the controls, then verify the actual storefront with the intended product and market.
- Add a quantity that crosses one of your tiers, and confirm the products, quantities and subtotal at checkout match the widget. You can inspect checkout without placing an order.
Was this article helpful?
Your feedback helps us improve our docs.