Skip to main content

​
What is a bundle?

A bundle is a subscription where the customer pays a single fixed price and assembles their order from a curated set of products you’ve made eligible. You define the bundle once — its name, fixed price, and how many items it contains — and customers fill it themselves from the product page. At checkout, a discount function spreads the fixed price evenly across the items the customer picked, so whatever combination they choose adds up to the same monthly total.

​
When to use a bundle

Curated boxes

Snack boxes, beauty boxes, coffee samplers — anything where the customer chooses N items from a larger catalog.

Build-your-own kits

Supplement stacks, meal kits, pet-food selections — the customer mixes and matches what they want.

Tiered "pick N" plans

“Pick 3 for €30 / month” or “Pick 5 for €45 / month” — sell the same catalog at different bundle sizes by creating a bundle template per size.

Sample subscriptions

Discovery boxes where the customer picks favourites each renewal rather than receiving a pre-set selection.
Use a regular subscription plan when the buyer subscribes to one specific product. Use a bundle when the buyer subscribes to a curated selection they choose themselves.

​
How bundles work

  1. You create a bundle template in the app: name, capacity (e.g. 3 items), fixed monthly price, and the products that are eligible to be picked.
  2. Each eligible product shows a Subscription bundle card on its product page with an “Add to bundle” button.
  3. The customer adds items to the cart until the bundle is full (e.g. 3 / 3).
  4. At checkout, a Shopify discount function evenly discounts the bundle’s cart lines so the bundle subtotal matches the fixed price you configured.
  5. After the order, Circuly creates the subscription contract and a bundle instance tied to that customer. They can swap items, manage the bundle, or reset it from the storefront.

​
Prerequisites

Before creating a bundle, make sure:
  • The Circuly theme extension is installed in your active theme — see Theme Extension Setup.
  • The products you want to include already exist in Shopify.
  • Each eligible variant is priced at at least the per-item share of the bundle price. The discount function can only discount lines down, never raise them. If the variant prices add up to less than the bundle price, the customer will be charged the higher variant price instead of the bundle price.

​
Create a bundle

1

Open Bundles in the app

In Shopify Admin, open Circuly Rental & Subscriptions → Bundles → Bundle templates, then click Create a bundle.
2

Fill in the basics

  • Bundle name (buyer-facing) — shown to the customer at checkout and on the manage page. Example: Snack box.
  • Internal code — merchant-facing identifier you’ll see in the admin and exports. Example: SNACK_BOX_3.
  • Items per bundle — how many items the customer picks per bundle. Example: 3.
  • Fixed monthly price — the total the customer pays each renewal, in your shop currency. Example: 30.00.
3

Pick the eligible products

Under Eligible products, search for and select every product that customers should be able to add to this bundle. The “Items per bundle” value is the maximum they’ll pick — they always choose from this list.
4

Review the summary and create

The summary on the right shows the per-item share (Fixed price / Items per bundle) so you can sanity-check pricing against your variant prices. When you’re happy, click Create bundle template in the top right.
You can edit a bundle template later — name, price, capacity, and eligible products are all editable. Any active bundles already built from the template keep their original settings; only new bundles assembled after the edit will use the new values. Templates with active subscriptions cannot be deleted.

​
Storefront experience

Once the bundle is created, every eligible product shows a Subscription bundle card on its product page (rendered inside the existing Unified purchase selector widget). The card has a pink header with the bundle name and monthly price, a progress bar showing N / capacity, and an Add to bundle CTA. A second block — Bundle progress — is available for the cart page or cart drawer. It surfaces the same counter inside the cart so customers see how many slots are left while they shop. See Theme Extension Setup → Bundle progress block to add it.

​
Bundle manage page

After the order is placed, the customer can open Manage your bundle from the product page card (or from their order confirmation) to view current items, swap items, or reset the bundle. This is a Circuly-rendered page served at /apps/api/bundle/<id> on your storefront — it inherits your theme’s layout.
Bundles are managed on the storefront only. Bundle controls do not appear in the Shopify Customer Account UI today — buyers reach their bundle via the product page CTA or the link in their order confirmation.

​
Monitor active bundles

In Shopify Admin, open Circuly Rental & Subscriptions → Bundles → Active bundles to see every bundle subscription customers have assembled. The index shows the following columns: Use the tabs at the top of the index to filter by status.

​
Pricing details

The bundle price is enforced by a Shopify Function discount that runs on the cart and at checkout.
Always set your variant prices so the eligible items sum to at least the bundle price. Otherwise customers will be charged more than the bundle price you advertised.

​
Limitations

  • Storefront-only management. Bundles are not surfaced in the Shopify Customer Account UI today. The PDP card and the bundle manage page are the buyer-facing controls.
  • Edits don’t propagate to existing bundles. Changing a template’s price, capacity, or eligible products only affects new bundles assembled after the edit. Active subscriptions keep their original terms.
  • Discount function must be active. Bundle pricing is enforced by Circuly’s discount function. If it’s been disabled under Shopify Admin → Discounts, bundle lines will charge at full variant price. Re-enable the Circuly bundle discount to restore bundle pricing.

​
Troubleshooting