# Bundles and quantity breaks: support guide

> Current answers on bundles: deal types, discounts, subscriptions and errors.

> The full reference for Section Store bundles. For one task or problem, see Related articles at the end.

## What it is

Bundles puts deal offers on the merchant's product pages, right above Add to cart. The shopper picks an offer, such as "Single", "Duo" or "Trio", and clicks Add to cart. The widget adds the right units, any free gifts and any ticked add-ons to the cart. Shopify then applies the discount in the cart and at checkout, through an automatic discount that Section Store creates and manages.

A bundle holds one or more offers. Each offer is one of four types:

- "Volume Discount": quantity breaks for one product (buy 2 save 15%, buy 3 save 25%).
- "Buy X get Y": buy some units, get more units of the same product free.
- "Mix & Match": the current product plus other products, each with its own price.
- "Complete the bundle": a Mix & Match offer that pairs the current product with set products.

A bundle can also have free gifts per offer, "Gifts to unlock" (gifts that unlock with bigger offers), "Checkbox upsells" (add-ons with a tick box), a subscribe-and-save choice and a countdown bar.

The menu item, the page title and the button in the row of page buttons are all "Bundles". The editor's title is "Block bundle".

## Words merchants use

Treat all of these as this feature:

- "quantity breaks", "volume discount", "tiered pricing", "bulk discount", "multi-buy", "buy more save more", "2-pack", "3-pack", "multipack"
- "BOGO", "buy one get one", "buy 2 get 1", "BXGY", "buy X get Y"
- "mix and match", "build your own bundle", "bundle builder", "pick any 3", "complete the set", "frequently bought together" (inside the bundle widget)
- "free gift", "gift with purchase", "GWP", "progressive gifts", "unlock gifts"
- "add-ons", "checkbox upsell" inside the bundle widget, "subscribe and save" inside the bundle widget
- "bundle block", "bundle widget", "deal block", "Bundles & Quantity Breaks" (old name)

Not this feature:

- The cart drawer's reward bar, free shipping bar, cart upsells and cart gifts. See the Cart drawer doc.
- Buy-box conversion blocks (sticky add to cart, Badges, Countdown timer, Addons, Upsell) outside the bundle. See the Conversion Blocks doc. The bundle's own "Countdown bar", badges and "Checkbox upsells" live inside the bundle. They are not those blocks, and not countdown or add-on sections from the catalog.
- "Section bundles": packs of theme Sections bought at a discount, a one-time charge. That is the Sections catalog.
- Shopify's own "Bundles" app, which makes fixed bundle products. Section Store never creates bundle products. It adds the real products as normal cart lines.
- "Shopify Plus" is Shopify's plan. "Plus" in this doc means Section Store Plus, the app's plan. Bundles needs Section Store Plus, not Shopify Plus.

## Plan and pricing

### Free versus Plus

Every store can, without Plus:

- Create, edit, preview and save bundles as drafts.
- Use the ready-made templates. Without Plus, templates keep their own words.
- Let an AI assistant (Claude, ChatGPT and others) build bundles. They stay drafts.

These need an active Plus subscription. A Plus free trial counts as active:

- Turning a bundle on: "Publish" in the editor, or the switch in the bundle list. Without Plus the editor shows "Unlock bundle publishing", "Save bundle drafts for free.", "Upgrade to publish live." and "Upgrade to Plus". The list switches are greyed out.
- Showing bundles to shoppers. Shopify only shows the "Bundles" app embed and the "Bundle" app block while the store has active Plus.
- The AI tools in the bundle editor: "Customize with AI", "Generate image", "Create from screenshot" and "Describe your bundle". Without Plus they say "An active subscription is required to use the AI assistant."
- Translating bundle text, A/B tests, the editor's automatic Shopify check and repair, and the market and language dropdowns in the editor's preview.

### Price and trial

- Plus costs $15/month. Older subscribers may keep $8 or $10.
- New stores get a 14-day free trial.
- A store that had Plus before gets only what is left of its first trial, never a fresh one.
- No revenue share or per-order fee.

### What happens when Plus ends

This is the most common source of confusion.

1. Cancelling during the trial ends Plus at once.
2. Cancelling a paid plan: the editor treats the store as without Plus right away ("Upgrade to Plus" replaces "Publish", list switches grey out). Shoppers keep seeing live bundles until the paid period ends. A save in that window makes the bundle a draft and deletes its Shopify discount. Subscribing again inside that period starts a new subscription. Billing starts on approval, with no credit for the days already paid for.
3. When Plus has ended, Shopify hides the "Bundles" app embed and the "Bundle" app block. The widget disappears from every product page.
4. The app does not switch bundles off. The list still says "Active". In the editor the badge says "Disabled": on in the app, but shoppers can't see it.
5. Checkout stops discounting too. Once Plus has ended, the bundle discount gives nothing, even on a cart that would qualify.
6. The app does not delete the Shopify discounts. Each live bundle's "Section Store Discount (bundle name)" stays active in Shopify Discounts. It gives nothing, but it still takes a slot in Shopify's discount limit.
7. To free a slot without Plus: open each bundle and click "Save". Saving without Plus makes it a draft and deletes its Shopify discount. Deleting the bundle also deletes its discount. Or turn the discount off in Shopify Discounts.
8. On subscribing again, the embed, the block and the discounts come back by themselves. Bundles still "Active" show again. A draft stays a draft until the merchant clicks "Publish".

Uninstalling the app sets every bundle to draft in the app.

## Where to find it

- Menu "Bundles", page "Bundles": "Packs, sets and gifts that make every order bigger."
- Without Plus, a banner says "You can create, edit, and preview bundle drafts now. Upgrade to Plus when you are ready to publish bundles on your live store."
- "Your best sellers could be earning more": "We lined up [number] deals that get shoppers to add more. Nothing goes live until you say so.", product photos and "Show me the deals", which opens "Deals for your store" on the "Add bundle" page. It shows only when we found deals, or when permissions are missing ("We line up deals that get shoppers to add more. Nothing goes live until you say so."). See Deals for your store under Step by step.
- No bundles yet: "Create your first bundle", "Bundles sit on the product page and show a better price for buying more.", three check lines, "Add bundle", "Create from screenshot" and a setup video ("Bundle setup tutorial").
- With bundles: a table with the filter chips "All", "Active" and "Draft" (each with a count), "Search by name", "Create from screenshot" and "Add bundle". Columns "Bundle", "Shows on" and "Status".
  - "Bundle": product photo, name and kind ("Quantity breaks", "Buy X, get Y" or "Mix and match"). An "A/B test" badge marks a bundle in an A/B test that hasn't ended.
  - "Shows on" reads the Products rule in plain words: "All products", the product name (or "<name> and 2 more"), "All except 1 product", "2 collections" or "All except 1 collection".
  - "Status" is "Active" or "Draft". Each row has an on/off switch, "Edit" and a "More actions" menu with "Duplicate bundle" and "Remove bundle" ("Delete bundle", "Are you sure?").
- "Theme setup" (shows once the store has a bundle): "We show bundles right above Add to cart." Buttons "Watch tutorial" and "Turn on in theme" ("Open theme" once the embed is on). Status "Live on your store", "Not on your store yet" or "We couldn't check your theme". With Plus, a live theme, an active bundle and the embed off, the card moves to the top as "Turn on bundles in your theme": "Shoppers can't see bundles until you do. We show them right above Add to cart." Without Plus the button is grey: "Upgrade to Plus to show bundles on your live store."
- "Templates": "deals from top stores" with a count, and "Browse templates", which opens "Templates" on the "Add bundle" page.
- "Build with AI": "Ask ChatGPT or Claude to make bundles." Buttons "ChatGPT" (opens "AI assistants") and "Claude" (opens Section Store in Claude's directory in a new tab).
- "A/B Tests" and "Translations" are separate menu items. The bundle editor also has a "Translations" button.

## How it works

### How the widget gets onto the product page

1. The "Bundles" app embed (the main way). In Shopify's theme editor it sits under App embeds. Once on and saved, it puts the bundle right above the theme's quantity selector and Add to cart on product pages with a matching live bundle. With no Add to cart found, it goes right after the price.
2. The "Bundle" app block. The merchant adds it by hand in the theme editor (Add block, Apps tab, "Bundle"). A placed block always wins over the embed. The embed itself can't be dragged, so the block is how a merchant moves the widget.

"Turn on in theme" opens the theme editor on a product page with the embed switched on. The merchant must then click "Save" in the theme editor. Until then, shoppers see nothing.

The embed and the block each have "Padding" settings: "Vertical" (default 10 px) and "Horizontal" (default 0 px).

The bundle shows on product pages only. Never in quick view, quick add, product cards, collection pages, the cart drawer, sticky add-to-cart bars, the header or the footer.

### Which bundle shows

- A bundle shows when it is live, its "Active dates" include now, and its "Products" rule matches the product.
- One bundle shows per product. If several live bundles match, the storefront shows one and hides the rest. We don't follow the order on the Bundles page, so check the product page. Fix overlaps by narrowing the "Products" rules.

### How the discount reaches checkout

1. When a bundle goes live, Section Store creates one Shopify automatic app discount for it: "Section Store Discount (bundle name)".
2. On Add to cart, the widget rewrites the add. It adds the offer's units, free gifts and ticked add-ons, and tags each line with the bundle and offer it came from. The lines are the store's real products. Inventory works as normal.
3. In the cart and at checkout, the discount reads those lines and the bundle's settings and discounts the right lines.
4. The widget's prices are a preview. Checkout decides the real price. They match in normal use.

Checkout labels: "15% OFF", "$5.00 OFF", "Buy 2, get 1 free!", and the gift's own text for gifts (default "+ Free Gift"). The "OFF" and "Buy …, get … free!" labels are English only.

### What the widget changes on the page

- It hides the theme's quantity box on Dawn-family, Horizon, Empire and Modular themes. On other themes the box stays on the page, but the picked offer decides what goes in the cart.
- It hides "Buy it now" while the picked offer can't use it: the offer has a quantity selector, uses more than one variant, has free gifts ("Text only" gifts included) or unlocks a product gift. A Mix & Match set of different products counts as more than one variant. A Mix & Match set also hides it when it isn't complete or has subscribe ticked. With no offer picked, the button shows.
- Tapping the picked offer again unselects it and closes it. No setting changes this. A developer can keep it selected with a short theme script. The script must wait for the bundle to load, so use the one in [Can I stop a second click from closing or collapsing the selected offer?](https://section-store.orka.help/a/stop-a-second-click-from-closing-the-selected-offer)
- With no offer picked, Add to cart works like the theme's normal button and the quantity goes back to 1. With no "Default offer", nothing is picked when the page loads.

## Deal types

### Volume Discount (quantity breaks)

- The shopper sees rows or tiles such as "Single", "Duo", "Trio", with prices, struck prices, badges and optional variant pickers per unit.
- "Quantity" is how many units the offer adds. "Price" is "Full price", "Percentage off", "Amount off" or "Fixed price". "Percentage off" and "Amount off" use "Discount per item". "Fixed price" uses "Total price", the price of the whole offer (2 for $30).
- Units of the same product count together across variants. Different products never add up in a volume discount. For mixed products, use Mix & Match.
- At checkout the biggest tier the cart reaches wins. With percent or amount off, that tier's discount covers every unit of the product. Example: tiers 1 (full price), 2 (15%), 3 (25%); 5 units get 25% off all 5.
- "Fixed price" works in packs. Example: 2 for $30 and 5 units: two packs at $30, the fifth unit falls to the next lower tier.
- "Full price" offers without gifts give no discount.
- Changing quantity in the cart moves the cart between tiers. Picking "Single" and raising it to 2 in the cart gets the 2-unit discount.

### Buy X get Y

- The editor reads "Buy [Quantity], get [Quantity] free!". Help text: "Buy X, get Y free. The free item is added automatically."
- Picking the offer adds Buy + Get units of the same product. "Buy 2, get 1" adds 3 units.
- At checkout, every full set of Buy + Get units gets the Get units 100% off. Leftover units can reach a lower offer.
- The free units are the same product. With mixed variants, they come from the line with the most units first, not the cheapest.
- To give a different product free, use "Free gifts" on the offer.

### Mix & Match

In the editor:

- The first item is always "Current product". It can't be removed. New offers start with two items at 10% off.
- "Add item" adds companions. "Products from": "All store products", "Selected products" (up to 20 products, with chosen variants), "Selected collection" (one collection per item) or "AI recommendations" (Shopify's "Related products" or "Complementary products" under "Auto recommendation type"; "Recommendation limit" 1 to 10, default 4). Complementary falls back to related when Shopify has none. Merchants manage them in the Shopify Search & Discovery app.
- Each item has "Quantity", "Price" ("Full price", "Percentage off", "Amount off", "Fixed price" with "Price per item") and "Title" ({{product_title}} works). Drag the handle to reorder items.
- "Require customers to choose a product" starts the slot empty. "All store products" always requires a choice. With it off, the first available product fills the row. Items added with "Add item" start with it on.
- "Layout": "Horizontal" or "Vertical". Horizontal scrolls sideways with more than two items.
- "Variant selector placement": "Keep variant selectors with the product details." (new offers start here) or "Put variant selectors on a separate row."
- The bundle's "Products" rule decides which pages show the offer. Only the current product has to match. Companions can sit outside the rule.

What shoppers see (new bundles use "Tap the product"):

- With the "Vertical" layout, rows join in one rail with a + between them. Each row has a photo, the title and the price on the right. Prices are per unit, with the normal price struck through. An item with a quantity above 1 shows the number on its photo.
- The current product's row says "This product". A swappable row says "Change product", and the photo and title open the picker too. A row with one possible product has no change line, unless the shopper had to choose it.
- An empty slot says "Choose product", with a line such as "Save 10% on any of 12 products", "Save 10% on any product", "12 products available", "1 product available" or "All store products".
- "Product unavailable": no product in that item's list can be sold. With "Require customers to choose a product" off, Add to cart adds the current product alone at full price. With it on, or with "All store products", Add to cart does nothing and shoppers see no message.
- The rows show on the picked offer. "Show products on every bundle deal" under "General styling", on the "Style" tab, shows them on all offers.
- An empty slot counts as the current product in the offer's total. "Show price of chosen products only" leaves it out until the shopper picks.

The product picker:

- Heading "Choose a product" (the merchant can change it), with the slot's own line under it, and "Search products".
- Each row has a photo, title, price, "Details" and a "Select" button. "Select" puts the product in the slot at once, on its first variant in stock. The product in the slot says "Selected".
- "Details" opens the product's own step: photos, price, option pickers and description with "Read more". "Select" at the bottom picks the chosen variant. A back arrow returns to the list. With the offer's "Variant selectors" off, the step has no option pickers.
- Sold out products don't show. The list loads 10 at a time and adds more on scroll, or with "Load more products". "No products found" shows when nothing matches. Search matches titles in a list. "All store products" uses Shopify's product search.
- The picker's corners and selected row follow the offer's style.

Styling lives on the "Style" tab, in "Fine-tune styling", "Product Picker":

- "Picker button", "Button style": "Tap the product" (new bundles), "Text link" (bundles saved before the new rows keep it, with text such as "Choose from 12 products"), "Full-width button" and "Switch icon".
- "Picker modal" opens "Product Picker Modal": "Title", "Search field placeholder", and the window, search field, button and photo styles. "Follow the deal" under "Colours" is on by default, so the search field and buttons take the deal's colors. Turn it off to set your own.
- "Quantity indicator" under "Fine-tune styling", "Mix & Match" styles the number on the photo.

In the cart:

- The items go in the cart as one set. The discount applies only while the whole set is in the cart with the right quantities. Removing one item, or changing one item's quantity, drops the discount for the whole set.
- Only the widget builds a set. Products added separately (collection page, quick add, another product page, "Buy it now", cart link, another app, draft order, POS) never count, with "Only apply discount to items added through this bundle block" on or off. No setting changes this. For the same product, use a "Volume discount" offer with that setting off. For different products, use a Shopify automatic discount.
- Without "Quantity selector", a set whose quantities are doubled in the cart also loses its discount. With "Quantity selector" on ("Repeats the set with the same products and variants."), the shopper picks how many sets, up to 100. The discount then stays while every item's quantity is the same multiple of the set. Adding the set through the widget twice makes two discounted sets.
- Add to cart waits for every required choice: "Choose a product to complete your bundle."

### Complete the bundle

"Complete the bundle" in "Add offer" ("Pair the current product with selected products to create a complete set.") creates a Mix & Match offer called "Complete the set", with the current product and a "Selected products" item at 10% off each. Everything above applies. It needs a companion product to publish: "Add a companion product to publish".

### Free gifts (per offer)

- In the offer's "More settings", turn on "Free gifts", click "Add gift", then "Select gift".
- "Gift type": "Product" adds a free cart line. "Text only" is "A promise in the card, like \"+ Free shipping\". Adds nothing to the cart."
- Product gifts: chosen variants (the shopper picks one) or "Any variant" ("Shoppers get the first variant in stock. No variant picker."). Also "Quantity", "Text" (default "+ Free Gift", also the checkout label) and "Show its value, struck through". Text gifts can have an "Icon" and a struck "Value".
- "Same gifts at any quantity" shows when the offer's quantity selector is on: "Shoppers get these gifts once, however many they buy." Off means gifts grow with the number of full offers.
- A gift is free only when it was added with its offer and the cart still reaches that offer. Dropping below the offer's quantity makes the shopper pay for it. Raising the quantity past a bigger offer can also cost it, since the bigger offer takes over and only its own gifts count. A gift product added by hand is never free.
- A gift with no variant in stock doesn't show and isn't added. Neither does one with fewer units in stock than its "Quantity".
- A "Text only" gift saying "Free shipping" gives no free shipping. Bundles never discount shipping. Use a Shopify shipping discount or the cart drawer's reward bar.

### Gifts to unlock

- Card "Gifts to unlock", switch "Show gifts to unlock": "Gifts show under the offers. A bigger offer unlocks more. Unlocked gifts go in the cart free."
- Up to 4 gifts, one unit each. "Title" defaults to "Unlock free gifts"; blank hides it. Each gift has "Unlocks from" ("Offer 1", "Offer 2" …), counted in the order shoppers see the offers. A gift unlocks at that offer and every later one.
- Each gift is "Product" or "Text only". {{product}} in the text shows the gift's name.
- Locked gifts show dimmed with "Locked"; unlocked ones show "Free". These words follow the shopper's language. The merchant changes them on the Translations page ("Change their words").
- An unlocked gift stays free while any unlocking offer is reached, so raising the quantity in the cart keeps it.

### Checkbox upsells (add-ons)

- Card "Checkbox upsells", "Block title", "Add upsell", "Select product". Each add-on has variants, a "Price" ("Full price", "Percentage off", "Amount off", "Fixed price"), "Title" (default {{product}}), "Subtitle" (default "Save {{saved_total}}"), "Selected by default", "Show product options only when selected", "Enable subscription" and "Only when this offer is selected" with "Show for these offers".
- A ticked add-on adds one unit per add to cart. Its discount applies only next to units of this bundle, for at most as many add-on units as bundle units, and only on the variants the merchant picked.

### Countdown bar

- Card "Countdown bar", switch "Show a countdown bar": "A tinted bar that counts down to the bundle's end."
- It counts down only to the bundle's end date. Set it with "End date" and "End time" in the card, or in "Active dates". They are the same date. Without one it never shows. The card says "Pick when this deal ends. The bar counts down to it, and the discount stops then." On A/B test versions B to D it says "Set the end date in version A. The bar shows only when the bundle has one." Those versions use the live bundle's end date, and the link in that message opens version A. It hides when the end passes. It never restarts and is the same for every shopper.
- "Place": "At the end, below the add-ons" or "Above the deals". "Bar text" default "Deal ends in {{timer}}". Also "Background", "Text", "Text size" (10 to 40) and "Corner radius" (0 to 100).

## Step by step

### 1. Start a bundle

Click "Add bundle". The "Add bundle" page ("How do you want to start?") has three choices. "Deals for your store" ("Built from your best sellers.", marked "Top pick") opens first. "Templates" and "Build your own" ("Describe it, or set every offer.") sit next to it. The header button "Start from scratch" opens plain quantity breaks.

- "Deals for your store": deals built on the store's own products, in its look. "Set up deal" opens the editor unsaved. See Deals for your store below.
- "Build your own", presets with "Choose": "Quantity breaks for the same product", "Buy X, get Y (BXGY) deal", "Quantity breaks for different products" (Mix and match), "Complete the bundle", "Subscription" ("Add Subscribe & Save on top of quantity breaks.") and "Choose your quantity" ("Three quantity tiers without variant selectors.").
- "Build your own", "Describe your bundle": type the deal, optionally "Add product" or "Attach reference image" (or drop a screenshot on the page), then click the arrow button. With words only, the editor opens on an unsaved bundle and the Bundle Assistant builds the deal in the form. With an image, AI saves a draft and opens it. Needs Plus.
- "Create from screenshot" on the Bundles page: a PNG, JPG or WebP up to 8 MB, then "Generate bundle". AI copies offers, colors and layout. Needs Plus. It can take a few minutes.
- "Templates" holds "Bundles from top stores": "Use this bundle", then "Match my store look" or "Use as it looks", then "Use bundle". A card shows the design on one of the store's best sellers in its look when the products fit, otherwise on a sample product. "Change" tries it on another product ("We can't build this deal on that product. Try another." when it can't). The editor opens unsaved on the card's product, or the best seller, with gift and add-on slots filled from the store's products. With Plus the words are rewritten for the product.

#### Deals for your store

Deals built from the store's own products, best sellers first. The kinds: "Multi-pack", "Kit", "Free gift", "Mix and match", "Pick any" and "Add-on". A product that already has a bundle is skipped, so the next product moves up.

- Loading: "Finding your deals", "This takes about 10 seconds.", then "Reading your products and prices", "Matching products that go together" and "Building your deals". A return visit within the hour opens at once.
- The first deal leads with "Best fit" and its kind badge. Each card shows a live preview in the store's look, why it fits, the product with "Change", and "Set up deal". Above them: "Nothing goes live until you publish."
- "Change" opens Shopify's product picker. If the deal can't use the product: "We can't build this deal on that product. Try another."
- Pack photo cutouts: "We're cutting out your photos. You can choose now." then a toast "Your pack photos are ready."
- "Set up deal" opens the editor unsaved, on that product, in the store's look. Errors: "We couldn't set up this bundle. Try again." or "Setup took too long. Try again."
- Under the deals: "We left out 2 products. They are free or not for sale." (with the store's count).
- No deals: "We couldn't find deals" with "We need at least one product shoppers can buy. Add one and try again.", or "Every product you sell has a bundle. Try a template or build your own." Load error: "We couldn't load your deals. Reload the page."
- Any plan can set up a deal and save it as a draft. Publishing needs Plus. With Plus, the bundle's words are written for the product.

New bundles start in the store's colors (when the app can read them) and in the store's main language.

### 2. Pick the products

"Products" card: "All products", "Selected products", "Exclude selected products", "Selected collections" or "Exclude selected collections", then "Select products", "Select excluded products", "Select collections" or "Select excluded collections". This rule decides where the widget shows and which cart lines the discount may touch.

A new bundle starts on "All products". Without this step, the deal applies to every product in the store. Set the rule before "Publish".

- Presets, "Start from scratch" and "Create from screenshot" start on "All products".
- "Describe your bundle" and "Customize with AI" never set this rule, even when the merchant names a product.
- A template starts on the store's best seller. If we find no product to use, it shows "This bundle shows on every product".
- Sidekick fills in the product or collection the merchant named. With neither, the bundle starts on every product.
- An AI assistant's bundle applies to all products unless the assistant sets a rule.

### 3. Set the offers

Under "Offers", click "Add offer" and pick a type. Each offer card shows its price fields, "Title", "Subtitle" and "Default offer". Only the first card starts open. "More settings" holds the rest. The card menu has "Duplicate", "Delete" and move up or down. Shoppers see the offers in this order. Tick "Default offer" on the offer picked when the page loads.

### 4. Style it

Open the "Style" tab for "General styling" and "Fine-tune styling". Or use "Variant picker and swatches", or "Customize with AI" in the preview column. See Look and style.

### 5. Turn it on

1. "Save" keeps a draft. "Publish" goes live and needs Plus. On a live bundle the button says "Save" and updates it at once.
2. Check the "Theme setup" card. If it says "Not on your store yet", click "Turn on in theme", then "Save" in the theme editor. The editor may also show "Your bundle isn't on your store yet" with "Turn on", "I've done it" and "Dismiss reminder".
3. Test on the live product page: pick an offer, add to cart, check the discount at checkout.

To turn a bundle off, use its switch in the bundle list ("Bundle unpublished"). The editor has no off button. Turning off also switches off its Shopify discount.

## Every setting explained

### Editor tabs

The editor has two tabs above the cards. "Setup" holds "Products", "Settings", "Offers", "Checkbox upsells", "Countdown bar", "Gifts to unlock" and "Subscription". "Style" holds "General styling" and "Fine-tune styling". The preview stays beside both, and one "Save" covers both. "Customize variant styling", "Customize upsell styling" and "Customize gift styling" open "Style" at the right section.

### Settings card

- "Name (internal use)": unique per store. Also names the Shopify discount, "Section Store Discount (name)".
- "Header title": the heading above the offers. Empty hides it. New bundles start with "Special Offer".
- "Active dates": "Start date", "Start time", "Set end date", "End date", "End time". The Shopify discount uses the same dates. New bundles start two days in the past, so they are active at once. After the end date the bundle stops showing, its discount ends, and within about 30 minutes the list shows it as "Draft".
- "Variants" (shows once an offer has "Variant selectors" on or "Checkbox upsells" is on):
  - "Variant choice": "Each item, the first pick fills the rest" (default), "Each item on its own" or "One choice for all items". With the first, each unit gets its own picker, so a Duo can hold two colors. Changing #1 copies the choice to the other units while they all match. #2 can still be changed afterward, and once units differ #1 leaves them alone. "Each item on its own" keeps every picker on its own. "One choice for all items" gives one picker for all units.
  - "Show item numbers (#1, #2)" (default on). "One choice for all items" hides it. Turning on "Show row photo" turns this off, because the photo marks each row. Turn it back on here to show both. "Mix & Match" offers and "Checkbox upsells" don't show the photo.
  - "Show variant selection for single quantity deal bar" (default on).
  - "Hide unavailable variant options" (default off).
  - "Add swatches" / "Edit swatches" and "Customize variant styling".
- "Pricing":
  - "Show the price as": "Total" (default), "Per item" or "Both". "Per item" and "Both" add "Per label" (default "per").
  - "Use product compare-at price": the struck price and savings use the compare-at price. Display only. The checkout discount always starts from the real price.
  - "Show prices without decimals".
  - "Pricing rounding" (volume discount offers only): "Off", "Round", "Round up", "Round down", "Round up to .99". Checkout uses the same rounding.
  - "Show price of chosen products only": "Leave unselected products out of the bundle total until the customer chooses them."
  - "Round set prices" (Mix and match offers only, off by default): "We round each discounted item to a whole price. Checkout charges the same." It uses the mode under "Pricing rounding". An item that would round down to free, or up to its full price, keeps its cents.
- "Cart and discounts":
  - "Skip cart and go to checkout directly".
  - "Only apply discount to items added through this bundle block": "Items added elsewhere don't count and get no discount." On by default for new bundles.
  - "Choose what this bundle combines with" (off by default): "Unticked discounts won't stack, cart rewards included." On shows three boxes, all ticked to start: "Order discounts", "Product discounts", "Shipping discounts". Off, the bundle combines with all three. In an A/B test, set it in version A. Other versions can't change it, since all versions share one Shopify discount.

### Offer settings

On the offer card:

- "Title" and "Subtitle". Variables: {{product}}, {{saved_total}}, {{saved_percent}}.
- "Default offer": picked on page load.

Under "More settings":

- "Selector style": "Circle", "Image" or "None". With "Image": upload, "Choose from products" or "Generate image" (AI). "Fit": "Fit inside" or "Fill the square".
- "Badge" ("Rectangle", "Rectangle (shine)", "Ribbon", with "Position"), "Title badge", "Benefits list" ("Show benefits only when selected").
- "Quantity selector": a + and − control in the offer, with its own "Spacing" panel. Volume Discount: "Customers choose the quantity. Offers switch automatically." Buy X get Y: "Counts paid and free items. Offers switch automatically." Mix & Match: "Repeats the set with the same products and variants." Up to 99 units above the biggest offer, or 100 sets for Mix & Match. Colors live in "Fine-tune styling", "Quantity selector".
- "Free gifts" (see Deal types).
- "Variant selectors": off means every unit uses the variant picked in the theme's own picker.

### Variant picker and swatches

"Selector type": "Default", "Variant dropdowns" or "Custom swatches". Custom swatches set a color or image per option value ("Import missing swatches" reads them from a product) and offer presets such as "Pill button", "Circular swatch" and "Swatch dropdown". Templates and AI tools use color swatches when colors can be named and dropdowns otherwise.

## Discounts and checkout

### The Shopify discount behind each bundle

- Each live bundle owns one Shopify automatic app discount, "Section Store Discount (bundle name)". A draft that was never published has none. A bundle turned off keeps its discount, switched off.
- It combines with order, product and shipping discounts, unless "Choose what this bundle combines with" is on. Then it combines only with the ticked kinds.
- Every save of a live bundle rewrites the discount's title, dates, combinations and settings. Hand edits in Shopify Discounts get overwritten. Change bundles in Section Store.
- Deleting a bundle deletes its discount. A duplicate ("name Copy 1") is a draft with no discount until published.
- Bundles discount products only, never shipping.

### Combining with other discounts and codes

- By default the bundle discount allows combining with all three kinds. "Choose what this bundle combines with", under "Settings" > "Cart and discounts", limits that. Unticked kinds won't stack with the bundle, cart drawer rewards included. Whether another discount stacks also depends on that discount's own "Combinations" settings. A code not set to combine with product discounts won't work next to a bundle discount. Fix it on that other discount in Shopify Discounts.
- When two product discounts target the same item, Shopify decides what applies, usually one per item (Shopify behavior, not app code).
- A line added through bundle A is never discounted by bundle B.
- Cart drawer upsell and reward-gift lines are never touched by bundle discounts. See the Cart drawer doc.

### Shopify's limit of active automatic discounts

- Shopify caps active automatic discounts per store, usually at 25. Each live bundle uses one, a live cart drawer uses one, and other apps' and hand-made automatic discounts count.
- At the limit, publishing fails and the bundle stays a draft: "Your store hit Shopify's limit of 25 active automatic discounts. Turn one off in Discounts, then try again." From the editor: "We saved your bundle as a draft. Your store hit Shopify's limit of 25 active automatic discounts. Turn one off in Discounts, then publish."
- Fix: Shopify admin, Discounts, turn off an automatic discount the store no longer needs, then publish again. Turning a bundle off always works, even at the limit.

### Sync check and repair in the editor

Opening a live bundle (with Plus) checks two things on Shopify: that the storefront has the latest saved bundle, and that its discount is active.

- Problems are fixed by themselves: the bundle is republished and an inactive discount is turned back on with the bundle's own dates. When the discount was restored, a green banner says "We restored this bundle's discount on Shopify. Your live bundle needs it. To keep it off, turn off the bundle." Otherwise no banner. After "Try again" works, a green banner says "Bundle is set up on Shopify".
- Shopify refused: red "We couldn't update your bundle on Shopify. Shoppers may see an older bundle or miss its discount until this works." with "Try again". Listed problems: "Your storefront doesn't have your latest saved settings.", "The Shopify discount for this bundle is inactive." or "Shopify allows 25 active automatic discounts and your store has them all. Deactivate one in Shopify, then try again."
- Shopify didn't answer: yellow "We couldn't check your bundle on Shopify. Shopify didn't answer. Check again." with "Check again".

There is no "Restore discount" button anymore. To restore an inactive discount, open the bundle.

If the discount was deleted in Shopify Discounts, opening the editor can't bring it back. Click "Save" on the live bundle, or turn it off and on, to create a new one.

## Subscriptions

- The bundle can show a subscribe-and-save choice. It needs a subscription app that adds selling plans to the products (Shopify Subscriptions, Recharge, Appstle or any app that creates Shopify selling plans). The editor says "Requires a subscription app installed." Section Store creates no plans.
- The "Subscription" card on "Setup":
  - Its switch turns it on and opens the card. "The bundle discount also applies to subscription orders."
  - "Header": empty hides it.
  - "Discount duration (billing cycles)": 0 means every order forever, 1 the first order only, 2 the first two, and so on. The default is 1, so renewals don't get the bundle discount unless the merchant changes it.
  - "Layout" (checkbox, radio buttons, stacked radio buttons) and "Display Position" ("Below bundle offers" or "Above bundle offers").
  - "Subscribe title" (default "Subscribe and Save"), "Subscribe subtitle", "One-time title" (default "One-time purchase"), "One-time subtitle". The one-time fields are off with the checkbox layout.
  - "Style like the offers", "Show prices" ("Subscribe shows its price with the one-time price crossed out."), "Hide a lone offer" ("With one full-price offer, shoppers see only subscribe or one-time. Variant pickers stay.") and "Subscribe benefits".
- The choice shows only when the product has selling plans. In Mix & Match, only plans every chosen product shares show. With none: "Subscriptions aren't available for this selection."
- The bundle discount and the subscription app's own discount both apply. A "Fixed price" offer is adjusted for the plan's own discount.
- Add-ons join the subscription with "Enable subscription" on the add-on.

## Languages, markets and currencies

### Languages

- New bundles start in the store's main language.
- Built-in widget words ("Choose product", "Change product", "This product", "Free", "Locked", product picker words) follow the shopper's language, in 31 languages.
- The merchant's own words (titles, subtitles, badges, gift text, bar text) are translated in Section Store: menu "Translations", first dropdown "Bundles", pick a bundle or "All bundles", pick the language, type or click "Auto-translate", then save. Not in Shopify's Translate & Adapt.
- Translating bundles needs Plus. The page lists the store's published Shopify languages. It may ask for read-only locale access first.
- Keep placeholders unchanged: {{product}}, {{saved_total}}, {{saved_percent}}, {{timer}}, {{product_title}}.
- "Auto-translate" results stay unsaved until reviewed and saved. Limits: 8 runs a minute, 50 a day.
- The editor's "Preview language" shows a translation. It needs Plus.
- Checkout labels ("15% OFF", "Buy 2, get 1 free!") stay in English.

### Markets and currencies

- Bundles work in every currency the store sells in. Prices show in the shopper's currency.
- Percent discounts work the same everywhere.
- "Amount off" and "Fixed price" are set in the store's currency and converted with Shopify's exchange rate, in the widget and at checkout. There are no per-market amounts, and the market's price rounding is not applied to them.
- The editor's "Preview market" shows another market's prices. It needs Plus.

## Look and style

- Both styling cards sit on the "Style" tab. "General styling" starts open and "Fine-tune styling" starts closed. Each closes with its chevron.
- "General styling": layout (list or grid; grid adds "Bundle options per row" and "Scale down sensitivity"), "Show products on every bundle deal", "Color presets", "Size presets" ("Compact", "Normal", "Spacious") and "Spacing & Roundness".
- "Color presets": "Your store" ("Colors from your store.", with "Use gradients"), then "Classic", "Slate", "Pearl", "Sand", "Rose", "Bloom". The old "Brand" tile is gone; bundles that used it keep their colors.
- "Fine-tune styling": every color, size and spacing, for offers in normal and selected state, badges, prices, pickers, gifts, add-ons and subscription rows. A section for a feature the bundle doesn't use stays hidden.
- Fonts follow the theme.
- "Custom Styles" (bottom of "Fine-tune styling"): switch it on, pick "All deals" (one CSS for every bundle in the store) or "This deal", paste CSS, click "Save". It reaches the variant pickers too. @import lines are removed. Custom CSS is the merchant's own code. We can't promise selectors survive widget updates.
- "Customize with AI" (Bundle Assistant): "Describe a change in plain words". Quick prompts "Match my brand colors" and "Match a screenshot". Changes show in the preview at once; "Undo last edit" reverts; nothing is kept until "Save".
- AI images: set "Selector style" to "Image" and click "Generate image". It uses the "Previewing product" photo and draws the offer's units, up to 10. The Bundle Assistant can make up to 6 images per request.
- The bundle AI tools (assistant, images, screenshot import, "Describe your bundle", template words) share one limit per store: 8 a minute and 50 a day. Messages: "The assistant is catching its breath. Try again in a minute." and "You've reached today's assistant limit. It resets tomorrow."

## A/B tests and AI assistants

### A/B tests

- Menu "A/B Tests", or "Create A/B test" in a live bundle's editor. Needs Plus and a live bundle ("Publish this Bundle before creating an A/B test.").
- Version A is the live bundle; B to D are copies. Results use paid orders with a product added through the bundle.
- Starting needs analytics and order permissions and the bundle in the live theme. The app embed counts, though the message names the "app block".
- After start, B to D are locked. Turning the bundle off pauses the test; the 90-day limit keeps running. A bundle in a running test can't be deleted ("End the A/B test before deleting its live item.").

### AI assistants

- "ChatGPT" on the Bundles page's "Build with AI" card leads to "AI assistants", which shows the "Server URL" and the steps for Claude, ChatGPT, Grok and other MCP clients. The merchant adds the URL in the assistant, then approves in Section Store.
- "Assistants build bundles and carts on any plan. Switching them on needs Plus." New bundles start off. A new bundle applies to all products unless the assistant sets a product or collection rule. Changes to a live bundle need the merchant's confirmation. Assistant changes can be undone for 30 days. An assistant can add up to 250 bundles per store.
- On the Cart Drawer page, "Manage" next to "Build with AI" lists assistants with "Disconnect". The Bundles page's "Build with AI" card has no "Manage".
- Shopify Sidekick can start a bundle too. The editor opens with "Sidekick started this bundle" and the product or collection filled in.

## Theme and app compatibility

- Works in Online Store 2.0 themes through the embed or the block. The embed knows Shopify's own themes (Dawn family, Horizon family, older free themes), many paid themes (Impact, Prestige, Focal, Warehouse, Impulse, Motion, Empire, Symmetry and others) and the GemPages, PageFly, EComposer and Shogun page builders.
- Unknown theme: the bundle goes above Add to cart's block, or after the price. If that's wrong, place the "Bundle" app block by hand.
- Headless storefronts (Hydrogen, custom front ends) are not supported. Bundles need a Shopify Online Store theme (Shopify platform rule).
- Products from another store's catalog (such as Shopify Collective items) show no bundle.
- Other bundle or quantity-break apps on the same product clash: two widgets, two add-to-cart rewrites, two discounts. Turn the other app off for those products.
- The widget leaves add-to-cart requests from several cart drawer and upsell apps alone so they keep working.

## Limits and things it cannot do

- One bundle per product. Product pages only.
- No setting stops a second tap from unselecting the picked offer (a developer can, with the JavaScript hook).
- Mix & Match counts only sets built in the widget.
- No shipping discounts.
- Volume Discount counts one product at a time. Buy X get Y gives the same product free.
- Mix & Match: 20 selected products per item, one collection per item, 1 to 10 AI recommendations per item, and at most 100 Mix & Match collections across a bundle and its A/B versions.
- Gifts to unlock: 4 gifts, one unit each.
- Size limits: "Bundle settings are too large to save (… bytes; maximum 128000). Remove some deal options, gifts or custom CSS. We didn't save your changes." Checkout settings: "The combined discount configuration exceeds Shopify's 10,000-byte limit" (A/B versions count). Translations: "Bundle translations are too large to save (… bytes; maximum 128000). Shorten the bundle text. We didn't save your changes."
- Amounts in the store's currency only. Checkout labels in English only.
- Shopify's active automatic discount limit caps live bundles together with other discounts.
- No bundle products, SKUs or subscription plans are created.

## Troubleshooting

### The bundle doesn't show on the product page

Check in this order:

1. Plus. Without active Plus the widget is hidden and the editor badge says "Disabled". Fix: start or resume Plus.
2. Draft. The list says "Draft". Fix: "Publish", or turn on its switch.
3. Theme. "Theme setup" (or "Turn on bundles in your theme" at the top) says "Not on your store yet". Fix: "Turn on in theme", then "Save" in the theme editor. Merchants often skip Save. The card can take up to 5 minutes to show the new status.
4. Wrong theme. Only the published theme counts. An embed turned on in an unpublished copy does nothing yet.
5. "Products" rule doesn't match the product.
6. "Active dates" start later or ended.
7. Another live bundle matches the same product and wins. Narrow the "Products" rules.
8. Wrong page: not a product page (quick view, collection, home page).
9. Refresh the product page after a change.

If all check out, open the chat bubble in the Section Store app or email help@section.store.

### The bundle is in the wrong place or squeezed

Cause: an unusual buy box, or another bundle app. Fix: add the "Bundle" app block where it should go. Adjust "Padding". Turn other bundle apps off. If the embed lands badly on a common theme, open the chat bubble in the Section Store app or email help@section.store with the product link.

### The discount isn't applied in the cart or at checkout

1. Open the bundle in Section Store. The editor re-checks and restores an inactive discount. Look for a green, red or yellow banner.
2. Discount deleted in Shopify Discounts: click "Save" on the live bundle to create a new one.
3. Plus ended or the bundle is a draft. Shopify Discounts can still show the discount as active after Plus ends. It gives nothing until Plus is back.
4. The cart no longer reaches the offer: quantity changed, a Mix & Match item removed, or below the offer's quantity.
5. "Only apply discount to items added through this bundle block" is on and the units came from elsewhere: quick add, collection page, "Buy it now", cart link, another app or POS. Fix: add through the widget, or turn the setting off.
6. The product isn't in the bundle's "Products" rule.
7. A code or another discount isn't set to combine with product discounts.
8. The offer is "Full price" without gifts.

If the bundle is live, no banner shows, the cart was built through the widget and checkout still shows no discount, open the chat bubble in the Section Store app or email help@section.store. Send the product link and a cart screenshot.

### "Buy it now" orders miss the bundle discount

"Buy it now" skips Add to cart, so its units carry no bundle tag and ticked add-ons stay behind. The widget hides "Buy it now" for offers with a quantity selector, more than one variant or gifts, but not for a simple offer. With "Only apply discount to items added through this bundle block" on, those orders get no bundle discount. New bundles start with that setting on. Fix: turn that setting off, so the units count toward "Volume discount" and "Buy X get Y" offers. Or hide the theme's dynamic checkout button. Mix & Match never counts these units. "Skip cart and go to checkout directly" gives a fast path that keeps the discount.

### Checkout price differs from the widget

- "Use product compare-at price" is on: the widget's savings use the compare-at price, checkout uses the real price. Expected. To turn it off, go to Apps > Section Store > Bundles, open the bundle, then open "Settings", then "Pricing". Click "Save".
- "Pricing rounding" changes volume discount prices, the same in widget and checkout. "Round set prices" does the same for Mix and match sets. With "Show the price as" on "Per item" or "Both" it rounds the unit price, otherwise the offer's total.
- "Show prices without decimals" changes the widget's display only. It hides "Pricing rounding", but a rounding set before still applies, in the widget and at checkout. To stop it: turn off "Show prices without decimals", set "Pricing rounding" to "Off", save.
- Buy X get Y with mixed variant prices: without a "Quantity selector" the widget counts the cheapest unit as free. Checkout takes free units from the line with the most units first.
- Other currencies: fixed amounts convert with Shopify's rate. Small differences are expected.
- Subscribe orders also get the subscription app's discount.
- For big differences in the store's own currency, open the chat bubble in the Section Store app or email help@section.store.

### "We saved your bundle as a draft" or "hit Shopify's limit"

Shopify's active automatic discount limit is full. Fix: Discounts in Shopify admin, turn off an unneeded automatic discount, publish again. Section Store can't raise the limit.

### Banners in the editor

- Red "We couldn't update your bundle on Shopify": read the listed problem. At the discount limit, free a slot, then "Try again". Otherwise "Try again" once, then open the chat bubble in the Section Store app or email help@section.store.
- Yellow "We couldn't check your bundle on Shopify": "Check again" after a minute. If it keeps coming back, the bundle's discount may have been deleted in Shopify Discounts. Click "Save" on the live bundle to create a new one.
- Green "We restored this bundle's discount on Shopify": no action. Someone turned the discount off in Shopify and the app turned it back on. To keep it off, turn the bundle off in Section Store.

### No "Publish" button, or the list switch is grey

No active Plus: "Upgrade to Plus" shows instead. On a live bundle the button says "Save", which is expected.

### Publish blockers

- "Add a free gift product to publish": a product gift has no product. Pick one ("Add free gift"), switch it to "Text only", or remove it. Turning off "Free gifts" doesn't clear this: the switch only hides the rows, and the empty gift still blocks "Save" and "Publish".
- "Add a companion product to publish": a Mix & Match item with "Selected products" has none.
- "Finish the checkbox upsell to publish": an add-on lacks a product or variants, or uses "Only when this offer is selected" with no offer.
- "Gifts to unlock: Gift 2: Pick a product." and similar. "The bundle has no offer 3. Pick another offer." means its offer was deleted.

### "Bundle settings are too large to save"

Too many offers, gifts, add-ons or too much custom CSS. Remove some. For the 10,000-byte message, also end any draft A/B test. If a small bundle fails, open the chat bubble in the Section Store app or email help@section.store.

### Free gift problems

- Not shown: no variant in stock, or the gift product isn't available on the online store.
- Charged at checkout: the cart dropped below the offer, moved up to a bigger offer, or the gift was added by hand.
- Shopper raised the gift's quantity: only the allowed number is free. Shopify may split the line.
- Gifts double with quantity: tick "Same gifts at any quantity".
- "Free shipping" text gift: text only. Use a Shopify shipping discount or the cart drawer reward bar.

### Mix & Match problems

- "Choose a product to complete your bundle.": a slot needs a choice. Expected.
- Discount lost in the cart: a set item was removed or its quantity changed. Remove the set and add it again. For several sets, turn on the offer's "Quantity selector".
- Items added separately don't count. Only the widget builds a set.
- Picker missing products: sold out, not on the online store or the shopper's market, or not in the item's list. With "Selected products", the count on an empty slot can include sold out products.
- "Product unavailable" on a row: nothing in the item's list can be sold. Add to cart adds the current product alone at full price, or does nothing when the row requires a choice. Add products that are in stock.
- "AI recommendations" empty: Shopify has no related or complementary products for it. Set them in Shopify Search & Discovery, or use "Selected products".
- An older bundle still shows a text link: set "Button style" to "Tap the product" under "Style", "Fine-tune styling", "Product Picker".

### Variant picker problems

- All units change together: set "Variant choice" to "Each item on its own". For one picker, pick "One choice for all items".
- Sold-out options show: turn on "Hide unavailable variant options".
- Wrong swatch colors or images: "Edit swatches" or "Import missing swatches".
- No pickers in an offer: "Variant selectors" is off; units use the theme picker's variant.

### The theme's quantity box disappeared or snaps back

The bundle controls quantity. Turn on "Quantity selector" in the offers for a + and − control.

### Subscribe option missing

The "Subscription" switch is off, the product has no selling plans, the variants aren't in the plan, or (Mix & Match) the products share no plan.

### Subscription discount only on the first order

"Discount duration (billing cycles)" is 1, the default. Set 0 for every order and save.

### Translations don't show

Saved? Right language? Language published in Shopify and on the shopper's market? Plus active? Placeholders intact? Checkout labels can't be translated.

### Countdown bar missing

No end date in the card or under "Active dates", or the end passed.

### A bundle switched itself to Draft

Its end date passed. Set a new end date or none, then publish. A publish at the discount limit also leaves a draft.

### AI tools refuse

- "An active subscription is required to use the AI assistant.": no active Plus.
- "The assistant is catching its breath…" or "You've reached today's assistant limit…": 8 a minute, 50 a day.
- "Choose a preview product first." or "This product doesn't have an image to generate from.": pick a "Previewing product" with a photo.
- "Attach a PNG, JPG, or WebP screenshot of a bundle widget (max 8 MB).": wrong file.

### "Missing access scopes" or "Permission required"

The app needs Shopify permissions for discounts, products, files, inventory and storefront reads: "To support bundle blocks, we'll request access to certain Shopify scopes." Click "Review access scopes" and approve. If it loops, open the chat bubble in the Section Store app or email help@section.store.

## FAQ

1. Is Bundles free? Building and saving drafts is free. Showing bundles to shoppers needs Section Store Plus: $15/month, 14-day free trial for new stores.
2. Do I need Shopify Plus? No. Bundles needs Section Store Plus.
3. Why can't I see my bundle? Check Plus, that the bundle is "Active", and that the "Bundles" app embed is on and saved in the live theme. Then check its "Products" rule and dates.
4. Where is the app embed? Online Store, Themes, Customize, App embeds, "Bundles". Or "Turn on in theme" on the Bundles page. Then click "Save".
5. Can I place the bundle elsewhere on the page? Yes. Add the "Bundle" app block where you want it. It replaces the embed's spot.
6. Collection pages or the home page? No. Product pages only.
7. Different bundles for different products? Yes, with each bundle's "Products" rule.
8. Two bundles on one product? No. One shows. Put all offers in one bundle.
9. Why no discount at checkout? Usually the bundle isn't live, Plus ended, units came from outside the widget while "Only apply discount to items added through this bundle block" is on, or the cart no longer reaches the offer. Open the bundle: it re-checks the Shopify discount.
10. Does it work with discount codes? Yes, if the code combines with product discounts in Shopify Discounts.
11. Other discount apps? Shopify decides how discounts on the same item combine, usually one per item. Another bundle app on the same page clashes.
12. What is the 25 discount limit? Shopify's cap on active automatic discounts. Each live bundle uses one. Turn off unused ones in Shopify Discounts.
13. Can a bundle give free shipping? No. Use a Shopify shipping discount or the cart drawer reward bar.
14. Different sizes or colors per unit? Yes, on by default ("Variant choice").
15. Can quantity breaks count different products together? No. Use Mix & Match.
16. Can a Duo hold two different colors? Yes. Each unit has its own picker, on by default ("Variant choice").
17. Does Mix & Match work on items added separately? No. Only sets built in the widget count.
18. Can a second tap on the picked offer stop closing it? No setting does this. A developer can use the JavaScript hook.
19. How do I set up buy 2 get 1 free? "Add offer", "Buy X get Y", Buy 2, Get 1. It adds 3 units and one is free. Delete the offers you don't want first. The "Buy X, get Y (BXGY) deal" preset also holds "Buy 2, get 3 free" and "Buy 3, get 6 free", and every offer left goes live.
20. Is the free unit the cheapest variant? Not always. It comes from the line with the most units first.
21. How do I add a free gift? Offer, "More settings", "Free gifts", "Add gift", "Select gift".
22. Gift out of stock? It doesn't show and isn't added.
23. Gifts that unlock with bigger offers? Yes, "Gifts to unlock", up to 4.
24. A deal for a sale period only? Yes, "Active dates" with "Set end date". A "Countdown bar" counts down to that real end, never a restarting timer.
25. Recharge or Shopify Subscriptions? Yes, with any app that adds selling plans. Turn on the "Subscription" switch.
26. Why does the subscription discount stop after one order? "Discount duration (billing cycles)" defaults to 1. Set 0.
27. How do I translate a bundle? "Translations", "Bundles", pick the language. Needs Plus.
28. Multiple currencies? Yes. Fixed amounts convert with Shopify's rate.
29. Colors and fonts? Colors, sizes and spacing on the "Style" tab. Fonts follow the theme. More with "Custom Styles" or "Customize with AI".
30. Can I A/B test a bundle? Yes, with Plus, under "A/B Tests".
31. What happens to bundles if I cancel Plus? When Plus ends they stop showing and stop discounting at checkout. Subscribing again brings back every bundle that still reads "Active". A draft stays a draft until the merchant clicks "Publish". Their Shopify discounts stay listed and take slots in the limit. To free a slot, open the bundle, change something and click "Save". That makes it a draft and deletes its Shopify discount. Or delete the bundle.
32. Can I copy a bundle? Yes, the duplicate button makes a draft copy.
33. What does deleting do? Removes the bundle and its Shopify discount. No undo.
34. Can I edit "Section Store Discount" in Shopify? Don't. The app rewrites it on the next save.
35. Why did my theme's quantity box disappear? The bundle controls quantity. Turn on "Quantity selector" in the offers.
36. Does it create products or SKUs? No. Real products go in the cart as normal lines.
37. Can AI build the bundle? Yes, with Plus: "Describe your bundle", "Create from screenshot", "Customize with AI", or an assistant through "Build with AI".
38. Headless store? Not supported. Bundles need an Online Store theme.

## When to contact us

Open the chat bubble in the Section Store app or email help@section.store when:

- Everything checks out (Plus, live, embed saved, products, dates) and the widget still doesn't show.
- A cart built through the widget gets no discount and the editor shows no banner.
- "We couldn't update your bundle on Shopify" stays after "Try again", other than at the discount limit.
- The widget breaks the product page, Add to cart or the layout.
- Shoppers are charged wrongly: gifts charged, or checkout far from the widget price.
- You have a question about refunds, billing or a trial.
- Permission requests loop.
- A bundle disappeared, or saved changes don't stick.
- You want a feature bundles don't have.

Send your myshopify address, the bundle name, a product page link and a screenshot of the cart or checkout.

## Related articles

### Start

- [Do I need Plus to use bundles?](https://section-store.orka.help/a/do-i-need-plus-for-bundles)
- [Create your first bundle](https://section-store.orka.help/a/create-your-first-bundle)
- [Start a bundle from a ready-made template](https://section-store.orka.help/a/143-start-a-bundle-from-a-ready-made-template)
- [Get bundle deals built for your store](https://section-store.orka.help/a/get-bundle-deals-built-for-your-store)
- [Create a bundle from a screenshot](https://section-store.orka.help/a/create-a-bundle-from-a-screenshot)
- [Describe your bundle and let AI build it](https://section-store.orka.help/a/describe-your-bundle-and-let-ai-build-it)
- [Start a bundle from Shopify Sidekick](https://section-store.orka.help/a/start-a-bundle-from-shopify-sidekick)
- [What Type and Status mean on the Bundles page](https://section-store.orka.help/a/what-type-and-status-mean-on-the-bundles-page)

### Deals

- [Set up quantity breaks (buy more, save more)](https://section-store.orka.help/a/set-up-quantity-breaks)
- [Set up a buy X get Y deal](https://section-store.orka.help/a/set-up-a-buy-x-get-y-deal)
- [Set up buy 2 get 1 free](https://section-store.orka.help/a/set-up-buy-2-get-1-free)
- [Set up a Mix & Match bundle deal](https://section-store.orka.help/a/119-how-to-set-up-mix-match-bundle-deals)
- [What shoppers see in a Mix & Match offer](https://section-store.orka.help/a/what-shoppers-see-in-a-mix-and-match-offer)
- [Change the Mix & Match product rows and picker](https://section-store.orka.help/a/change-the-mix-and-match-product-rows-and-picker)
- [Set up a Complete the bundle offer](https://section-store.orka.help/a/set-up-a-complete-the-bundle-offer)
- [Add a free gift to a pack or bundle offer](https://section-store.orka.help/a/add-a-free-gift-to-a-bundle-offer)
- [Same gifts at any quantity on bundle offers](https://section-store.orka.help/a/134-same-gifts-at-any-quantity-on-bundle-offers)
- [Unlock free gifts with bigger bundle offers](https://section-store.orka.help/a/145-unlock-free-gifts-with-bigger-bundle-offers)
- [Add checkbox upsells (add-ons) to a bundle](https://section-store.orka.help/a/add-checkbox-upsells-to-a-bundle)
- [Add subscribe and save to a bundle](https://section-store.orka.help/a/96-bundles-quantity-breaks-how-to-enable-subscription)
- [Add a Quantity selector to bundle offers](https://section-store.orka.help/a/128-add-a-quantity-selector-to-bundle-offers)
- [Add a countdown bar to your bundles](https://section-store.orka.help/a/142-add-a-countdown-bar-to-your-bundles)

### Settings and look

- [Set start and end dates on a bundle](https://section-store.orka.help/a/set-start-and-end-dates-on-a-bundle)
- [Pick which products show a bundle](https://section-store.orka.help/a/pick-which-products-show-a-bundle)
- [Edit offer titles and show the savings with variables](https://section-store.orka.help/a/edit-offer-titles-and-use-variables)
- [Set the default offer and change the order of offers](https://section-store.orka.help/a/set-the-default-offer-and-order-of-offers)
- [Add badges to bundle offers](https://section-store.orka.help/a/add-badges-to-bundle-offers)
- [Round bundle prices and show the price per item](https://section-store.orka.help/a/round-bundle-prices-and-show-price-per-item)
- [Show the compare-at price on a bundle](https://section-store.orka.help/a/show-the-compare-at-price-on-a-bundle)
- [Only discount items added through the bundle](https://section-store.orka.help/a/only-discount-items-added-through-the-bundle)
- [Send shoppers straight to checkout from a bundle](https://section-store.orka.help/a/send-shoppers-straight-to-checkout-from-a-bundle)
- [Change bundle colors, sizes and layout](https://section-store.orka.help/a/change-bundle-colors-sizes-and-layout)
- [Set up variant pickers and swatches on a bundle](https://section-store.orka.help/a/set-up-variant-pickers-and-swatches-on-a-bundle)
- [Can shoppers pick a different color for each item in an offer?](https://section-store.orka.help/a/pick-a-different-color-for-each-item-in-an-offer)
- [Change a bundle with Customize with AI](https://section-store.orka.help/a/change-a-bundle-with-customize-with-ai)
- [Generate AI images for your bundle deals](https://section-store.orka.help/a/118-generate-ai-images-for-your-bundle-deals)
- [Preview a bundle on another product, market or language](https://section-store.orka.help/a/preview-a-bundle-on-another-product-market-or-language)

### On your store

- [Show bundles on your product page with the Bundles app embed](https://section-store.orka.help/a/137-show-bundles-on-your-product-page-with-the-bundles-app-embed)
- [Place a bundle with the Bundle app block](https://section-store.orka.help/a/place-a-bundle-with-the-app-block)
- [My bundle widget is in the wrong place or under the description](https://section-store.orka.help/a/why-is-my-bundle-in-the-wrong-place)
- [Which themes work with bundles?](https://section-store.orka.help/a/which-themes-work-with-bundles)
- [Turn a bundle off](https://section-store.orka.help/a/turn-a-bundle-off)
- [Duplicate or delete a bundle](https://section-store.orka.help/a/duplicate-or-delete-a-bundle)

### Problems

- [Why isn't my bundle showing on my product page?](https://section-store.orka.help/a/why-isnt-my-bundle-showing)
- [Two bundles match one product. Which one shows?](https://section-store.orka.help/a/two-bundles-match-the-same-product)
- [Why isn't my bundle discount applied at checkout?](https://section-store.orka.help/a/why-isnt-my-bundle-discount-applied-at-checkout)
- [Why doesn't Buy it now get the bundle discount?](https://section-store.orka.help/a/buy-it-now-and-the-bundle-discount)
- [Why is the checkout price different from the bundle widget?](https://section-store.orka.help/a/why-is-checkout-price-different-from-the-bundle)
- [What happens when a shopper changes the quantity in the cart?](https://section-store.orka.help/a/quantity-changes-in-the-cart-and-bundle-discounts)
- [Why isn't my Mix & Match discount working?](https://section-store.orka.help/a/why-isnt-my-mix-and-match-discount-working)
- [Why doesn't Mix & Match apply to items added separately?](https://section-store.orka.help/a/mix-and-match-items-added-separately)
- [Why are products missing from the Mix & Match picker?](https://section-store.orka.help/a/products-missing-from-the-mix-and-match-picker)
- [Why is my free gift missing or charged at checkout?](https://section-store.orka.help/a/why-is-my-free-gift-not-showing-or-charged)
- [Why do my bundle variant pickers change together or show sold out options?](https://section-store.orka.help/a/why-do-all-bundle-variants-change-together)
- [Why isn't subscribe and save showing on my bundle?](https://section-store.orka.help/a/why-isnt-subscribe-and-save-showing-on-my-bundle)
- [Why does the bundle discount stop after the first subscription order?](https://section-store.orka.help/a/why-does-the-bundle-discount-stop-after-the-first-subscription-order)
- [Why did my theme's quantity selector disappear?](https://section-store.orka.help/a/why-did-my-themes-quantity-selector-disappear)
- [Can I stop a second click from closing or collapsing the selected offer?](https://section-store.orka.help/a/stop-a-second-click-from-closing-the-selected-offer)
- [Why can't I publish my bundle?](https://section-store.orka.help/a/why-cant-i-publish-my-bundle)
- [Bundle settings are too large to save](https://section-store.orka.help/a/bundle-settings-are-too-large-to-save)
- [Why did my bundle go back to draft?](https://section-store.orka.help/a/why-did-my-bundle-go-back-to-draft)
- [Why won't the bundle AI tools work?](https://section-store.orka.help/a/why-wont-the-bundle-ai-tools-work)
- [Permission Required or Missing access scopes on the Bundles page](https://section-store.orka.help/a/missing-access-scopes-on-the-bundles-page)

### Discounts and limits

- [Your store hit Shopify's limit of 25 active automatic discounts](https://section-store.orka.help/a/shopifys-limit-of-25-automatic-discounts)
- [What the green, red and yellow banners in the bundle editor mean](https://section-store.orka.help/a/bundle-editor-banners-green-red-and-yellow)
- [What is the Section Store Discount in Shopify Discounts?](https://section-store.orka.help/a/what-is-the-section-store-discount-in-shopify-discounts)
- [Can shoppers use a discount code with a bundle?](https://section-store.orka.help/a/use-discount-codes-with-bundles)
- [Can I use another bundle app with Section Store bundles?](https://section-store.orka.help/a/other-bundle-and-discount-apps-with-section-store-bundles)
- [Bundles with multiple currencies and markets](https://section-store.orka.help/a/bundles-with-multiple-currencies-and-markets)
- [What happens to my bundles when Plus ends?](https://section-store.orka.help/a/what-happens-to-my-bundles-when-plus-ends)
- [What bundles can't do](https://section-store.orka.help/a/what-bundles-cant-do)
- [Can a bundle give free shipping?](https://section-store.orka.help/a/can-a-bundle-give-free-shipping)
- [Do bundles create new products or change my inventory?](https://section-store.orka.help/a/do-bundles-create-products-or-skus)
- [Can a bundle show on collection pages or quick add?](https://section-store.orka.help/a/can-a-bundle-show-on-collection-pages-or-quick-add)