Skip to main content

How to Create a Build-a-Box Subscription with Subi

Set up a Build-a-Box subscription plan in Subi that lets customers create custom product bundles with discounts.

Build-a-Box lets your customers create their own product bundle by choosing items from a list you curate. They pick the required number of items (for example, 3 or 6). Once the box is complete, Subi automatically applies the price or discount you set.

What Build-a-Box supports

You can sell a Build-a-Box as:

  • A one-time purchase

  • A subscription (a recurring box)

  • Both, so the customer chooses at checkout

And you can price it in two ways, set in the Box structure section of the plan editor:

  • Fixed price: one set price for the whole box, no matter which items the customer picks.

  • Discount: a percentage or fixed amount off the total of the items the customer picks.

The next section explains both in detail.

How box pricing works

Every Build-a-Box uses one of two pricing models, chosen in the Box structure section of the plan editor. Each box size can have its own price or discount.

Fixed price

You set one price for the box, for example "$40 for any 6 items". The customer always pays that price, whatever they put in the box. This is ideal for curated boxes where you want a clean, predictable price.

Box structure set to Fixed price in the Subi plan editor

Discount

The box price is the total of the chosen items, minus a discount you set, and it updates as the customer adds items. You can set the discount as:

  • Percentage: a percentage off the total of the chosen items, applied across all items in the box.

  • Fixed amount: a set amount off the box, distributed across the items (so it doesn't appear as a single discount line at checkout).

Box structure set to Discount in the Subi plan editor

How the price is calculated

  • Pricing applies per box, not per cart. Each box is priced on its own.

  • A customer can add more than one box to the same cart, and each box keeps its own price.

When the box price applies

The box price (or discount) is applied only when all of these are true:

  • All items belong to the same box size

  • The whole box is either one-time or subscription, not a mix

  • The box has exactly the required number of items

  • Every item comes from the box's product pool

Subscription discounts

When a box is both discounted and subscribed, Subi applies the discounts in sequence rather than adding them together:

  1. Build-a-Box discount

  2. Subscription discount

Who should use Build-a-Box?

For merchants

Use Build-a-Box to offer custom product bundles, subscription boxes, or flexible promotional kits.

For customers

Customers can build their own product box from a curated list and subscribe to recurring bundles.

Step 1: Create a Build-a-Box plan in Subi

  1. Go to your Subi dashboard.

  2. Open Plans (the Subscription Plans page).

  3. Click Create plan.

  4. Select Build a box.
    ​

    Selecting Build a box when creating a new plan in Subi

Then fill in the plan settings below.

Why is my new Build-a-Box plan already filled in?

When you create a Build-a-Box plan from the Plans page and your store already sells a live Subscribe and save plan, Subi opens the new plan already filled in from your newest one, so you can save it right away. A blue banner at the top, We filled this in from your shop, names the plan the values came from.

  • The Box name, the products (or the collection, or all products) and the delivery frequency come from your Subscribe and save plan. If that plan uses collections, the new box also copies whether it follows them, so the collection checkbox may start unticked.

  • One box size is added: Small, with 3 items. If your Subscribe and save plan gives a percentage discount, the box size gets the same percentage; otherwise it starts at 0%.

  • The plan-level subscription discount stays at no discount, because it would be added on top of the box size discount at checkout.

  • Saving publishes the plan to your store.

You can change any of these values before you save, and you can close the banner. If your store has no live Subscribe and save plan, Subi takes the products and the frequency from your newest live Build-a-Box, Fixed Bundle or Volume Discount plan instead, with no name and no discount carried over. If it has none of these either, the page opens empty, as before.

Plan details

  • Plan title: the name of the bundle.

  • Plan description: an internal or display description.

Product pool

Choose which products customers can pick from. You can add products in two ways:

  • By collection: select a collection to include all of its products.

  • Manual selection: choose specific products individually.

Customers can only choose products from this pool.

Does my box update when I change its collection?

Yes, if the checkbox under your selected collections is ticked. It reads Products added to or removed from these collections will automatically be added to or removed from this plan. It is ticked by default on new boxes. On boxes you created before it existed, it is ticked on most, but when we launched it we unticked it on some, for example on a box with no one-time purchase.

  • When you add a product to the collection in Shopify, it appears in your box builder at the next hourly update, without saving the plan again.

  • When you remove a product from the collection, customers can no longer pick it for a new box, and it no longer gets the box price.

  • Existing subscriptions are not changed: a subscriber who already has that product keeps it at the same price on renewal.

  • These automatic updates don't send you the Your Plan Update is Complete! email. You get it only when you save the plan yourself.

  • If a product was removed from your box by hand, it stays out even while it is still in the collection. To bring it back, contact support.

If your box has no one-time purchase, a second line under the checkbox says This plan has no one-time purchase, so products added later will be sold on subscription only. Untick the checkbox and save if you want the box to keep only the products it has now.

Box sizes

Define how many items customers must select for each box size (for example, a box of 3 items or a box of 6 items).

Customers must select exactly this number of items before they can add the box to their cart.

Box structure & pricing

Choose how the box is priced under Box structure:

  • Fixed price: set one price for each box size.

  • Discount: choose Percentage or Fixed amount, then set the discount for each box size.

Each box size can have its own price or discount.

If you change the Box structure of an existing plan, the prices or discounts you entered are cleared so you can re-enter them under the new model. Your box-size names and item quantities are kept. See Troubleshooting below.

Subscription settings

If you let customers subscribe, set the subscription frequency and any subscription discount rules. This step is required when subscription purchase is enabled.

Purchase type

Choose how customers can buy: one-time, subscription, or both.

Combinations: can customers use an order discount code with the box discount?

Yes, if you turn it on. Below your selling plans, the Combinations card has an Order discounts toggle. When it is on, a customer who also enters an order discount code at checkout keeps the box discount as well, so both discounts apply. When it is off, which is the default, only one of the two applies.

  • The setting is saved when you click Save on the plan page.

  • It is one setting for your whole store: it applies to every Build-a-Box, so turning it on in one box turns it on for all of them. Fixed bundles have their own setting.

  • The toggle shows what Shopify currently has for your box discount, including a change made outside Subi.

The order discount code must also allow it. In Shopify admin, open the code under Discounts and, under Combinations, tick Product discounts. Shopify combines two discounts only when each one allows the other.

Product and order discounts combine at checkout only in stores that use no checkout.liquid customizations.

Save the plan

After you save, Subi generates a Box ID. You'll need this ID to display the widget on your storefront.

Step 2: Add the Build-a-Box widget to your store

Creating the plan does not automatically show it on your store. You add the widget yourself.

  1. Copy the Box ID from Subi.

  2. In your Shopify admin, go to Online Store → Themes.

  3. Click Edit theme.

  4. Navigate to the section where you want the widget.

  5. Click Add block.

  6. Select Apps.

  7. Click Build box widget (Subi Subscriptions).
    ​

    The Build box widget block under Apps in the Shopify theme editor
  8. In the right-side panel, enter the Box ID.

  9. Click Save.
    ​

    Entering the Box ID in the widget settings, then clicking Save in the Shopify theme editor

Does “Display on each product page” put my box on my product pages?

No. Each Build-a-Box has a setting called Display on each product page, and Subio or Shopify Sidekick may tell you whether it’s on when you ask about a box. On or off, the setting doesn’t put your box on any page of your store.

Your box shows only where you add the Build box widget block and enter that box’s Box ID, as in Step 2. To show it on your product pages, open a product page in the theme editor and add the block there. It then shows on every product that uses that template.

Why does the theme editor show a warning on the Build box widget?

If the Build box widget can’t show a box, the theme editor shows a warning on the block. Customers never see this warning. On your storefront, the widget just stays empty until you fix it.

  • Box ID not found: the Box ID you entered doesn’t match any active box in Subi. In Subi, open your box, choose Copy box ID, paste it into the block’s setting, and click Save. The Box ID is a code like 3f2a…, not the box’s name.

  • No Build-a-Box box yet: your store has no active box in Subi. Create a box first (Step 1), then paste its Box ID into the block. If you don’t plan to offer a box, remove the block.

What customers see

On your storefront, customers will:

  1. Open the Build-a-Box section

  2. Select a box size

  3. Choose one-time or subscribe, and a frequency

  4. Choose products from the available pool

  5. Add items until the required quantity is reached

  6. Add the box to cart
    ​

    The Build-a-Box widget on the storefront with the product list and the box summary

How the price appears

The widget always shows one clear price, the price the customer actually pays:

  • Fixed-price box: the customer sees just your set price.

  • A box with a saving (a discount, or a subscription discount): the customer sees the original price struck through and a single "Save X%" (or "Subscribe & Save X%") label.

  • The full breakdown (box discount, subscription discount) is tucked behind a Details link, so the default view stays clean.

A fixed-price box, one-time, shows just the set price:

Build-a-Box widget showing a single clean fixed price

A box with a saving shows a clean headline price with "Subscribe & Save" and a Details link:

Build-a-Box widget showing the original price struck through, the discounted price, and a Save percentage label

The same box with Details expanded, so the full breakdown is one tap away:

Build-a-Box widget with the Details disclosure expanded, showing the box discount and subscription discount

Early access: product filters and grouped variants

We're piloting two ways to make a large Build-a-Box easier to shop. Both are part of an Early Access Program: they're switched on for a limited group of stores while we gather feedback, and you can ask to join (see How to join the Early Access Program below).

Build-a-Box widget showing Material and Type filter chips above the product list, with the list narrowed by the selected filters

Product filters

When your box draws from a large product pool, you can let customers narrow the list by tapping filter chips. Each filter has a name you choose (for example, "Material" or "Type") and is built from one or more of your Shopify collections.

Customers tap a chip to show only the products in that collection, then tap it again (or tap Clear all) to return to the full list. You can add more than one filter so customers can combine them.

You set filters up in the Filters section of the Build-a-Box plan editor:

  1. Click Add filter.

  2. Enter a Label for the chip. This is the text customers tap, for example “Material” or “Type”.

  3. Under Collections, click Browse and choose the collection (or collections) the filter should match.

  4. Repeat to add more filters, then Save.

The Filters section of the Build-a-Box plan editor, showing a Material filter and a Type filter, each with a Label field and a Collections picker

Filters are set up when you edit an existing box, not while you create it. Create your Build-a-Box plan and save it first, then open it again to add your filters.

Grouped product variants

When a product comes in several variants (for example, the same item in five colours), the widget shows it as a single product card with a variant picker instead of a separate card for every variant. Customers pick the variant they want on the card, then add it to the box.

This keeps the product list short and easy to scan, even for catalogs with lots of variants. Grouping turns on automatically for products that have variants, so there's nothing extra to set up.

A Build-a-Box product card for an item with five colour variants, shown as one card with a colour picker and an Add to box button

How to join the Early Access Program

These features aren't switched on for every store yet. To try them on your store, reach out to our team and ask to join the Build-a-Box early access program:

We'll enable it for your store and help you set up your first filters.

Troubleshooting

The Build-a-Box widget isn't showing

Check that:

  • The widget block is added to the theme

  • The correct Box ID is entered

  • Theme changes are saved

The most common cause is a missing or incorrect Box ID.

My prices disappeared after I changed the Box structure

This is expected. When you switch an existing plan between Fixed price and Discount, the amounts are cleared because a price and a discount are not the same thing (a "15% discount" can't be safely reused as a "$15 price"). Your box-size names and item quantities are kept.

To finish the switch, enter a price (or discount) for every box size, then Save. Saving is blocked until every box size has a value.

The price looks different from what I expected

  • Fixed-price boxes show one clean price (your set amount) with no discount breakdown by default.

  • Discounted boxes show the price with a "Save X%" label; tap Details to see the box discount and subscription discount separately.

  • Subscription discounts are applied in sequence (after the box discount), which affects the final price.

I turned on Order discounts but the code still replaces the box discount

  • Check the order discount code in Shopify admin: under Combinations, Product discounts must be ticked.

  • Check that your store uses no checkout.liquid customizations; with them, product and order discounts do not combine.

  • Reload the Build-a-Box plan page and confirm Order discounts is still on.

Need help?

Did this answer your question?