Build a box
Updated today
The build-a-box section powers a collection-backed bundle builder: customers pick products and variants, adjust quantities, and see a tiered discount applied in a running summary before adding the bundle to their cart.
Settings
Setting | Description |
|---|---|
Collection | Selects which collection supplies the products customers build their box from. No collection or an empty one shows placeholder cards. |
Products to show | How many products from the collection the builder displays, from 1 to 24 (default 12). |
Variant picker type | Shows variants as a Dropdown (default) or Buttons. |
Show swatches (when available) | Displays color swatches on the variant picker when your product data provides them (on by default). |
Card media aspect ratio (mobile and desktop) | Sets the product-card image shape: Square (default), Natural, Landscape, or Portrait. |
Use inner border radius | Applies an inner border radius to product media (on by default). |
Minimum quantity | Lowest total items a customer can add to a box, from 1 to 19 (default 1). |
Maximum quantity | Highest total items a customer can add to a box, from 1 to 20 (default 3). The quantity control caps each product at this value. |
Discount tiers | Four item count and discount (%) pairs that unlock as the box grows (see defaults below). |
Show progress bar | Shows a progress bar that marks the next discount tier (on by default). |
Discount tier defaults
Tier | Item count | Discount |
|---|---|---|
First | 1 item | 5% |
Second | 2 items | 15% |
Third | 3 items | 30% |
Fourth | 5 items | 45% |
Each tier's item count is adjustable from 1 to 20 and its discount from 0% to 90%; the progress bar displays milestones such as 1 item / 5% OFF and 3 items / 30% OFF based on your tiers.
Blocks and behavior
The section shows an optional intro above the product cards only when you add content blocks to it. The default preset adds a heading block and a body text block for this intro.
Each product card exposes Add to bundle and a Quantity control, plus Decrease quantity and Increase quantity buttons. Items appear in the Bundle summary, which lists Subtotal, Bundle discount, and Total — all starting at $0.00. Customers remove a line item with the Remove control.
The Add bundle to cart button is disabled until a customer adds products to the box, so an empty bundle can't be submitted.
To walk through adding and configuring this section on a page in the theme editor, see Set up a Build-a-box bundle section.