1. What bundles are Starter plan and above
A bundle is a group of products sold together at a bundle discount. Sublyra supports two modes:
| Mode | What the shopper does | Good for |
|---|---|---|
| Build-a-box | Picks a set number of items (between your minimum and maximum) from the products you chose. | Snack boxes, sample kits, "pick any 4" offers. |
| Fixed bundle | Buys the whole set as one unit — no picking. | Starter kits, curated routines, gift sets. |
Both modes can be sold as a one-time purchase or made subscribable through any of your selling plan groups. The discount is a real automatic discount in Shopify, so the price the storefront advertises is the price checkout charges — no discount codes for the shopper to remember.
2. Create a bundle
1 In the Sublyra admin, go to Settings → Bundles & boxes.
2 In the Create a bundle card, pick the mode: Build-a-box (shoppers pick items between your min and max) or Fixed bundle (the whole set sells as one unit).
3 Fill in the fields:
| Field | What it does |
|---|---|
| Bundle name | Shown at the top of the storefront block. |
| Minimum / Maximum items (build-a-box only) | How many items the shopper must pick (1–50). The box can't be added to cart below the minimum, and the picker stops at the maximum. A fixed bundle sells the whole set, so these fields don't apply. |
| Bundle discount (%) | 0–90. 0 means no discount. Applied automatically at checkout once the box reaches the minimum (build-a-box) or the whole set is in the cart (fixed bundle). |
| Subscription (optional) | Pick a selling plan group and the box can be subscribed to — its products are attached to the group for you. Leave it on One-time purchase only for one-time boxes. |
| Box products | Click Choose products and pick the products the shopper can choose from (or, for a fixed bundle, the products in the set). At least one product is required. |
4 Click Create bundle. Saving does three things: it snapshots product titles, images and prices into the storefront metafield, it creates (or updates) the automatic checkout discount, and — for subscribable boxes — it attaches the products to the selling plan group.
3. How the bundle discount works
When you save a bundle with a discount above 0%, Sublyra creates an automatic discount in Shopify named Sublyra bundle — <your bundle name>. Key behaviours:
- It fires on the cart, not on a code. For a build-a-box, the discount applies once the cart holds at least the minimum number of the bundle's products. For a fixed bundle, once the whole set is in the cart.
- It also fires for hand-assembled carts. If a shopper adds the same products to their cart one by one — without using the box builder — the discount still applies once the cart qualifies. Nothing is lost by browsing the normal way.
- Deactivate pauses it, delete removes it. Toggling a bundle off pauses its discount; deleting the bundle removes the discount from Shopify entirely.
- Set the discount to 0% and it disappears. Saving a bundle with
0removes any previously created discount for that bundle.
write_discounts scope, which is requested on the install screen. If the store installed before that change, an amber "Additional permission needed" banner appears at the top of the page — click Grant access, approve on Shopify's screen, and save again.
4. Subscribable boxes
Link a bundle to a selling plan group and the box becomes a subscription product:
1 Create a selling plan group first if you don't have one — Subscriptions → Selling plans in the Sublyra admin. The group defines the delivery frequency (for example, every month).
2 On the bundle form, choose that group under Subscription (optional) and save. Sublyra attaches the bundle's products to the group automatically — no separate trip to the Selling plans page.
3 On the storefront, the block now offers a Subscribe & save path alongside the one-time purchase. The whole box is added with the group's first selling plan, and Shopify turns the checkout into a subscription contract like any other subscription order.
Every line of a box carries a shared _bundle_id line property, so the set stays grouped in the cart, on the order, and in your Shopify admin — fulfilment can see which items shipped together.
5. The Box Builder and Fixed bundle theme blocks
Bundles render through app blocks in the theme editor — no code, no theme editing by hand.
1 In Shopify admin, go to Online Store → Themes → Customize.
2 Open the template where the bundle should appear (a page, the home page, or a product template).
3 Click Add block (or Add section) → Apps, then choose:
| Block | Shows | Settings |
|---|---|---|
| Box Builder | One build-a-box bundle: the shopper picks items, sees the running total with the discount, and adds the whole box in one click. | A single bundle ID field. Copy the ID from the bundle's card under Your bundles (it appears under the bundle name). Leave it blank to show your first active build-a-box bundle. |
| Fixed bundle | Every active fixed bundle as its own card: item list with thumbnails, the set total (struck through with a "save X%" note when discounted), and a one-click add. Subscribable sets get a Subscribe & save button too. | None — all active fixed bundles render automatically. |
4 Save the theme and open the page on your storefront to see it live.
6. Edit, deactivate, delete
| Action | Effect |
|---|---|
| Edit | Loads the bundle back into the form. Saving updates the storefront snapshot and the automatic discount in one go — always re-save after changing prices in Shopify. |
| Deactivate | Hides the box from the storefront and pauses its discount. The setup is kept, so you can switch it back on any time. |
| Delete | Removes the bundle, its storefront block output and its automatic discount for good. Existing subscription contracts are not affected — subscribers on a bundle subscription keep renewing. |
7. FAQ
Can a shopper buy a box one-time and subscribe to it later?
Yes. When the bundle is linked to a selling plan group, the block offers both paths — one-time purchase and Subscribe & save. The shopper picks per order.
What happens if a bundle product goes out of stock?
The box builder only lets shoppers pick products that are available for sale. If an item sells out, it stops being selectable until it's back in stock.
Does the bundle discount combine with the subscription discount?
The bundle discount is an automatic discount on the products; the subscription discount comes from the selling plan's pricing. Shopify applies automatic discounts according to its own combination rules — test a checkout on your store to see the final numbers before you promote the offer.
How many bundles can I create?
There's no fixed limit in the app. Each bundle renders through its own Box Builder block placement, and the Fixed bundle block shows every active fixed bundle as its own card.
Can I offer a volume discount without a box?
Yes — that's what quantity breaks are for: "buy 3+, save 10%" tiers on a single product instead of a multi-product box.