Build-a-box

Build-a-box lets a customer assemble their own recurring order from a selection you control. Coffee roasters, snack boxes, supplements and pet food all use this: the cadence is fixed, the contents are the customer's choice.

Setting one up

1. Create a box and give it a customer-facing name.
2. Choose the products that can go in it.
3. Set the box size — how many items must be chosen. A fixed size (exactly 6) or a range (6 to 12).
4. Set pricing: a price for the box, or let it total the items chosen.
5. Attach a delivery cadence, exactly as for a normal plan.

What the customer sees

On the product page the widget shows a picker rather than a plain subscribe button. The customer chooses their items, sees a running count against the box size, and cannot check out until the box is valid.

The picker reads prices from your storefront, so what it shows is what your store shows — including the right currency for the market the shopper is in.

Why the picker reads storefront prices

An earlier version priced the box from the admin API, which reports in your shop currency. On a store selling in several currencies that quoted a $7 item at ₹510. The picker now reads the same prices your theme does, so the two can never disagree.

Changing the contents later

Subscribers can edit their box from the customer portal between deliveries. Changes apply from the next delivery onward — a box already charged is not retrospectively altered.

This is the main reason build-a-box retains well: a customer who is bored of one item swaps it instead of cancelling.

Rules and validation

• A box must have at least as many eligible products as its minimum size
• Removing a product from the eligible list does not break existing boxes; it simply cannot be added to new ones
• Quantity limits per item are respected — a customer cannot take six of a one-per-box item

Combining with other features

Build-a-box works with prepaid — a customer can prepay three months of a box they assembled. It also works with loyalty rewards, so a long-standing box subscriber can be moved to a better price.