Build a Box

Build a Box is a post-purchase offer type where the shopper assembles their own box from a set of products you curate, and buys the whole selection in one transaction. Instead of accepting or declining a single product, they choose what goes in and how many — and a volume discount can deepen as the box fills. It sits alongside the single-product and multi-product post-purchase offers, and composes with the usual offer widgets — heading, timer, and the rest.

​

Setting up the box

​

Choosing candidate products

The Product selection section controls which products a shopper can choose from. These are called candidates.

1. Open the box offer in the post-purchase funnel editor.
2. Expand Product selection.
3. Select Add product and pick one or more products. Products already on the list are excluded from the picker.
4. Save.

A box supports up to 12 candidates. Drag the handle on a row to reorder — that’s the order shoppers see. Use the delete icon to remove one; you can’t remove the last remaining candidate, since a box needs at least one.

​

Box size

Box size sets how many items the shopper must choose: With a fixed-size box, the editor notes that shoppers must choose exactly that many items and will see a “0 of N selected” counter.

​

Discounts

​

Discount tiers

The Box discount section sets a discount that scales with how many items are in the box. Add a tier with Add tier, then set Minimum items for tier N and Discount for tier N. How the rate is chosen:

• The shopper gets the deepest rate their box qualifies for, not simply the last threshold crossed. If you configure 3+ items at 30% and 6+ items at 20%, a shopper with 6 items still gets 30%.
• The rate is evaluated at the live item count, not at the box minimum. A tile opens at full price and re-prices as the box fills, so the rate a shopper is quoted is always the rate their current selection actually earns.
• An empty tier table is valid and means the box sells at full price.

There is no box-wide discount cap — the tier table is the only thing that sets the rate. The editor shows advisory warnings for three tier shapes that look unintended. None of them block saving:

​

Per-product discounts

A candidate can carry its own discount instead of following the box rate. Open the candidate, go to Discount, and check Give this product its own discount.

• The override applies on that product’s tile and in the box total, in place of the tier rate.
• 0 is a valid override — it holds a product at full price inside an otherwise discounted box.
• Leave the override off to follow the box discount.

​

Editing several products at once

Edit all products opens a bulk panel. Uncheck any candidate you want to leave out of the edit. Where the selected products differ, a field shows Mixed — editing it writes your value to all of them, and leaving it alone preserves each product’s own value. The override toggle shows an indeterminate state when only some have overrides.

​

Per-product settings

Each candidate has its own panel, covering Badge, Image, Product details (including review ratings, with star colours defaulting to #fdcc0d and #d1d5db), Variant options, Box limits, Discount, and Design (card style Subdued or Emphasized). Two settings under Box limits are worth calling out:

• Show quantity selector — on by default. Turn it off so each add puts in exactly one unit, with no per-tile quantity stepper.
• Maximum quantity in a box — leave empty for no limit, or set it to 1 to keep a variety box varied.

The Already purchased section controls what happens when a shopper already has this product — bought on the current order or accepted at an earlier step in the funnel. Matched on product ID, so a different variant of a purchased product still counts. Choose one of three treatments: When Show a “Your choice” badge is selected, three additional settings appear:

• Badge text — the wording on the badge. Leave blank to use your store’s translation (set in Settings > Translations under Already purchased badge). Defaults to “Your choice”.
• Badge color — the fill color of the badge pill (hex, default #008060).
• Badge text color — the text color inside the badge pill (hex, default #ffffff).

The badge is visible in the funnel editor preview, so you can see how it looks before publishing.

​

Progress and layout

Box progress controls the fill indicator: There is no “hidden” position. To drop the progress line entirely, clear the progress text field.

​

Progress text variables

Type { in the progress text field to insert a variable. The step-header variables available on multi-product offers have no box equivalent and are not offered here.

​

Progress wording

Progress wording sets what the progress line says at each point in the fill. Leave a field empty to inherit from Settings → Translations, which in turn falls back to the shopper’s language — so a merchant who never opens this section keeps every translated language. {COUNT}, {MAX} and {RATE} are filled in at display time — keep them in your wording.

​

Tile button text

The Tile button text section in the Buttons panel lets you customize the wording on the Add and Remove buttons that appear on each candidate tile, for this funnel only.

• Add button text — the label shown on a tile before the shopper adds the product to their box. Defaults to “Add to box”.
• Remove button text — the label shown on a tile after the shopper has added the product. Defaults to “Remove”.

Leave either field blank to use your store’s translation from the Translations page. If the store translation is also blank, the English default is used. The unavailable state label (“Unavailable”) is not affected by these settings. To set store-wide defaults for these labels instead of a per-funnel override, go to Translations in the Aftersell admin and update the Add to box and Remove from box entries.

​

Limitations

• One shared accept button. The box has a single call to action rather than per-product buttons, because Shopify caps how many accepts a post-purchase page can make.
• No replacement offers. A box can’t be used as a replacement upsell.
• The price breakdown doesn’t collapse. Show price breakdown, under General settings, turns it on or off. When it’s on it is always expanded — the multi-product offer puts its breakdown behind a “Show price breakdown” link instead.

​

Adding a box to an existing subscription

A box can be added to a subscription the shopper’s order created. Under the box’s subscription settings, tick Add this box to the customer’s existing subscription. On accept, the items they picked join that subscription: they’re charged for the first box now, and it repeats with the subscription. Two things gate it:

• A subscription provider must be connected. Without one, nothing in the configuration is served.
• Skio only, today. The accept path runs this through Skio. If you’re connected to another provider the editor warns you, because the offer would otherwise save and then silently never modify anything.

Once Skio is connected, Delivery frequency lets you retime the subscription. Only plans that every product in the box offers are listed — pick Keep their current frequency to leave it unchanged. If a product is later added that doesn’t share the saved frequency, the box resets to the shopper’s current frequency and the editor tells you.

​

Subscription-only products

Products configured to sell only as a subscription (requiresSellingPlan: true in Shopify — no one-time purchase option) cannot be included in a build-a-box offer. Every item in a box is charged as a one-time purchase on the order, so Shopify rejects subscription-only products at serve time. These candidates are silently dropped on every real order, even though the funnel editor preview continues to show them. The funnel editor warns you when this situation is detected:

• Warning banner — some candidates are subscription-only but enough non-subscription candidates survive to reach the box minimum. The banner lists the affected products by name. The offer still shows to shoppers, but with fewer products than configured.
• Critical banner — all candidates are subscription-only, or the surviving non-subscription candidates cannot reach the box minimum. The offer is skipped entirely for every shopper.

If you see the warning banner, the box still works — it just serves fewer products than you configured. Add more candidates that can also be bought once, so the box carries the range you intended. If you see the critical banner, the offer won’t run at all until you fix it. Any of these clears it:

• Add candidates that can also be bought once.
• Lower the box minimum, so the surviving candidates are enough to reach it.
• Turn off “subscription only” on the affected products in Shopify, if they should also sell as a one-time purchase.

You can also remove the subscription-only candidates from the box entirely. That changes nothing for shoppers — they’re already dropped on every real order — but it silences the banner and makes the editor preview match what actually serves. Subscription-enabled products (those offering both a one-time purchase and a subscription) aren’t dropped from a box. They’re simply sold as a one-time purchase, like every other box item — a box never carries a selling plan.