Skip to main content
Storefront widget & display

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.

Bundlex Bundles quantity selector tutorial cover with a quantity control and Buy 1 and Buy 2 offer cards.
See how to enable the selector, change quantities for individual items and complete bundles, and choose its position. English captions are available. Open the video tutorial page or Watch on YouTube.

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

  1. Open your bundle and go to the Add-ons tab.
  2. Switch on Quantity selector.
  3. Choose its position and, for Inside the offer, which eligible offers should show it.
  4. Save. Activate the discount if it is Draft, then test the storefront.
Bundlex Bundles Add-ons tab with Quantity selector enabled, Inside the offer selected and all four Show on offers checked beside the cream preview.
1. Enable Quantity selector in Add-ons. 2. Choose its Position. 3. Choose which eligible offers show it inside their cards. Select the image to view it at full size.

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.

Aurelia cream product page with Daily Glow Duo selected, two sets totaling $108, both component prices and the Add to cart button visible.
The selector counts complete sets: 2 means two face creams and two serums. This current USD example totals $108, verified in the drawer and checkout. Select the image to view it at full size.

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.

Revitalize Face Cream storefront with Buy 3 selected, quantity 4 and a discounted total of $89.60.
1. The stepper now selects four items. 2. The Buy 3 tier gives 20% off, so four $28 creams cost $89.60. The drawer and checkout matched this subtotal. Select the image to view it at full size.

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.

Three real editor previews comparing the quantity selector inside the selected offer, above all offers, and below all offers.
The same Buy 1 selection with the control inside, above or below the offers. Purple outlines mark the quantity control. Select the image to compare at full size.
  • 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:

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.

Thanks - we'll keep improving this article.

Want to chat with our team? Still have a question?

Still need help?

Our team is one click away. Send us a message and we'll get back to you.

We use a few cookies to keep this site working, measure how it is used, and power our chat widget when you open it. See our cookie policy.