Most quantity break widgets only ask one question: how many units of this exact product do you want? A complete the bundle cross sell adds a second option right inside the same tier table—letting shoppers pick a tier that includes a matching accessory, refill or companion product at the tier’s discount.
Instead of stacking a separate recommendation slider below your buy button, you keep every choice in one widget. This guide explains how in-tier add-ons work, how they compare with free gifts and standalone widgets, how to check the margin math, and how to set them up in Sam Bundles. For a broader look at every bundle format on Shopify, see our product bundles guide.
What is a “complete the bundle” cross-sell inside quantity breaks?
Standard quantity breaks are a pure upsell: buy 1 at full price, buy 2 for 10% off, or buy 3 for 15% off. A cross-sell suggests a different product that pairs with the main item, such as a wick trimmer with a candle or conditioner with a shampoo. Our upsell vs cross-sell guide covers the difference between the two.
When you put add-on items inside quantity breaks, you combine both ideas in one bar. A tier can increase the unit count of the main product, attach one or more companion products, or do both at once. Every item in that bar receives the bar’s discount and goes into the cart with one click on Add to cart.
Here are four common ways stores structure the bars:
| Bar setup | Bar 1 | Bar 2 | Bar 3 | Best for |
|---|---|---|---|---|
| Multi-pack + top kit | 1 unit (full price) | 2 units (10% off) | 3 units + tool (15% off) | Candles, coffee, supplements |
| Single vs starter kit | 1 unit (full price) | 1 unit + add-on (10% off) | 2 units + add-on (15% off) | Apparel, shoe care, accessories |
| Routine step-up | 1 cleanser (full price) | 2 cleansers (10% off) | 2 cleansers + toner (15% off) | Skincare and hair care |
| Refill bundle | 1 bottle (full price) | 1 bottle + 1 refill (10% off) | 1 bottle + 3 refills (20% off) | Home cleaning, soap, body care |
Because the companion product sits inside the radio bar the shopper is already reading, they see the combined price and total savings before clicking the buy button.
How does an in-tier add-on compare with a separate cross-sell widget?
On Shopify, you have three main ways to suggest a complementary product on the product page: a native recommendation block, a standalone bundle widget, or an add-on inside a quantity break bar.
- Shopify’s native complementary products block. Using the free Search & Discovery app, you can pick up to 10 complementary products per item and display them in a theme block (Shopify developer docs). By itself, this block offers no discount and no “add all” button. If you pair it with a native Buy X get Y discount, Shopify notes in its Buy X get Y help guide that “the free or discounted ‘get’ item is never automatically added to the cart.” The shopper has to add both products separately.
- A standalone fixed bundle or frequently bought together box. A fixed bundle sells a pre-set group of products at one price in its own widget. That works well when you do not offer multi-unit tiers on the main item. If you already run a quantity breaks table on the page, adding a second bundle box underneath it forces shoppers to choose between two competing widgets.
- Complete the bundle inside a quantity break bar. The companion item lives inside the tier card. The shopper picks one bar—either a standard multi-pack tier or the tier with the companion product—and clicks the main Add to cart button once.
| Feature | Native complementary block + BXGY | Standalone fixed bundle widget | Complete the bundle in quantity breaks |
|---|---|---|---|
| Widgets on the page | 1 recommendation block | 1 bundle box (2 if paired with tiers) | 1 combined tier widget |
| Added in one click | No, shopper adds each item | Yes | Yes |
| Multi-unit tiers included | No | No | Yes, up to 20 bars |
| Discount shown on page | Only if written in page copy | Yes | Yes, inside the bar |
For a full breakdown of native recommendations and checkbox widgets, see our frequently bought together guide. To compare fixed sets with customizable boxes, read fixed bundles vs mix and match vs bundle builder.
How is “Complete the bundle” different from a free gift on a tier?
In Sam Bundles, every quantity break bar gives you two ways to attach extra products: Add free gift and Complete the bundle. They look similar on the storefront, but they affect your margin differently.
- Add free gift attaches one product to the bar at $0 (100% off). You absorb the full cost of goods sold (COGS) for that item. That fits low-cost samples, scoops or pouches.
- Complete the bundle attaches one or more products to the bar at that bar’s discount. If the bar takes 15% off, both the main product and the companion items get 15% off.
Here is an example with hypothetical numbers. Suppose you sell a $30 shampoo that costs you $9, and a $24 conditioner that costs you $7:
| Offer structure | What the customer gets | Customer pays | Your cost | Gross profit |
|---|---|---|---|---|
| 1 unit (Bar 1) | 1 shampoo | $30.00 | $9.00 | $21.00 |
| 2 units at 10% off (Bar 2) | 2 shampoos | $54.00 | $18.00 | $36.00 |
| 2 units at 10% off + Add free gift | 2 shampoos + 1 free conditioner | $54.00 | $25.00 | $29.00 |
| 2 units + Complete the bundle (15% off) | 2 shampoos + 1 conditioner (all 15% off) | $71.40 | $25.00 | $46.40 |
In this example, giving a $24 conditioner away for free on the 2-unit bar drops profit from $36.00 to $29.00. Using Complete the bundle at 15% off raises the order total to $71.40 and leaves $46.40 in gross profit—while still saving the shopper $12.60 off the $84.00 combined retail price.
Use free gift with purchase when the extra item costs you a few dollars. Use Complete the bundle when the companion item is a full-priced product. You can check your own numbers with our bulk discount margin math guide.
How do you set up “Complete the bundle” in Sam Bundles?
Sam Bundles is free on the Shopify App Store and supports up to 20 tiers per quantity breaks offer. Follow these steps to attach discounted companion products to a tier.
Step 1: Turn on the app embed
Install Sam Bundles and open the app. In the Setup guide, open Enable app embed and click Active app embed. Toggle Sam Bundles on in the theme editor and click Save. The install and enable guide shows each screen.
Step 2: Create a quantity breaks offer
On the app home page, scroll to Offers and click Create new offer. Pick a Brand color and click Choose on Quantity breaks for the same product.
Under Products, apply the offer to All products, Selected products or Selected collections, and use Select exceptions if you want to leave specific products out. In Settings, set your internal Name, the Block title shown above the widget, and the Discount name shown in the cart and at checkout.
Step 3: Set the bar price and click Complete the bundle
Open the bar where you want the cross-sell to appear. Set the main product Quantity and choose a Price rule:
- Full price: no discount.
- Percentage off: takes the same percentage off the main product and every companion item in the bar.
- Amount off: subtracts a fixed dollar amount from each unit in the bar.
- Fixed price: sets a target unit price per item (items already cheaper than the fixed price keep their regular price and are never marked up).
Scroll to the bottom of that bar’s settings. Next to Add free gift, click Complete the bundle and select one or more companion products from the product picker. You can click Change products to add more items or Remove next to any item.
In the live preview and on your storefront:
- Each companion product appears inside the bar as
+ Product titlewith its thumbnail, discounted price and strikethrough original price. - The bar’s total price, compare-at total,
{{saved_percentage}}token andSAVE {{saved_total}}badge automatically include the companion items.
Step 4: Configure add-ons, combinations and publish
Below the bars, switch on any add-ons you need: Badges (such as Most Popular), a Savings summary, a Sticky add to cart bar, or a Countdown timer paired with Schedule.
Under Advanced, tick which discount classes (Product discounts, Order discounts, Shipping discounts) the offer can combine with, and set Customer eligibility if needed. Click Save to publish. Full details are in the quantity breaks documentation and offer settings guide.
How do variants, cart lines and checkout discounts work?
Three storefront and checkout mechanics matter when you run an in-tier cross-sell:
- Variant selection inside the bar. When a shopper selects a bar that includes Complete the bundle items, any companion product with multiple variants shows its own variant dropdown inside the bar. Sold-out variants are marked
(Sold out)and disabled. If the shopper picks a variant with a different price, the bar’s total and savings update immediately. See quantity breaks with size and color variants for more on multi-option setups. - Itemized cart lines in one click. Clicking Add to cart adds the main product units and all selected companion variants to the cart in one request as separate line items, so your fulfillment team sees each SKU clearly.
- Complete-set checkout verification. At checkout, Sam Bundles’ Shopify Discount Function checks that the main product and every companion product from that Complete the bundle bar are present in the cart before applying the discount. That lets you run a
1 unit + 1 add-on at 15% offbar right below a1 unit at full pricebar without the two 1-unit bars colliding. And if a shopper removes the add-on in the cart drawer, the bundle discount drops off automatically.
If you sell in multiple languages, you can translate bar titles and system labels using the Translations button in the editor and the translations page.
What rules keep bundle cross-sells honest and clear?
When you discount an add-on product conditionally upon buying another item, keep your pricing transparent. In the US, the FTC’s guide on bargain offers based upon the purchase of other merchandise (16 CFR 233.4) outlines key principles (this is general information, not legal advice):
- Do not raise the regular price. Increasing the regular price of the required item or reducing its quality to offset the bundle discount can mislead shoppers. Keep your 1-unit bar at your true everyday price.
- Make terms clear at the outset. The bar should clearly list the companion products and the combined total before the shopper clicks Add to cart.
- Keep companion items compact and relevant. Limit a bar to 1 or 2 companion products so mobile cards stay easy to scan, and prefer Percentage off when the main product and accessory have very different prices.
What should you test before publishing your offer?
Run a quick check on a phone before promoting the offer:
- Select the bundle bar. Check that the companion product row and variant dropdown fit cleanly on mobile.
- Switch the companion variant. Confirm that sold-out options are disabled and price changes update the bar total.
- Add the bar to the cart. Verify that all items land in the cart with your Discount name applied.
- Remove the companion item in the cart. Confirm that removing the add-on removes the bundle discount from the remaining item.
- Check your analytics after two weeks. Use the Performance Overview table on the Sam Bundles home page to track additional revenue, orders generated and AOV increase. For more ways to structure your tiers, read our quantity breaks guide.
Frequently asked questions
What is a 'complete the bundle' cross-sell in quantity breaks?
It is a quantity break tier that includes one or more complementary products alongside the main product. When a shopper selects that bar and clicks Add to cart, both the main product units and the companion items go into the cart together, and every item in the bar receives that bar's discount.
How is Complete the bundle different from Add free gift in Sam Bundles?
Add free gift attaches one product to a tier at $0 (100% off). Complete the bundle lets you attach one or more companion products that are discounted at the same rate as the bar—whether that is a percentage off, an amount off per item, or a fixed price—so you do not give away the full product cost.
Can shoppers choose the size or color of the add-on product?
Yes. When a shopper selects a quantity break bar with Complete the bundle items, any companion product with multiple variants shows its own variant dropdown inside the bar. Sold-out variants are marked as sold out and disabled.
What happens if a shopper removes the add-on item in the cart?
In Sam Bundles, the checkout discount function verifies that every item from the Complete the bundle bar is still in the cart. If the shopper removes a companion product or the main product from the cart, the bundle bar discount no longer applies.
Can I offer a 1-unit starter kit bar next to a 1-unit single bar?
Yes. Because Sam Bundles tags the items added from a Complete the bundle bar and checks for the complete set at checkout, a 1-unit + add-on bar at a discount will not conflict with a standard 1-unit bar at full price.
Sources
Part of our guide: Product bundles →