The Build-a-box section is 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.
Build a box
Updated last month
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.
FAQ
What is the Build-a-box section in Pops?
How many products can a Pops Build-a-box show?
The Products to show setting controls how many products from the selected collection the builder displays, from 1 to 24 (default 12).
How do the Pops Build-a-box discount tiers work?
Four item count and discount (%) pairs unlock as the box grows. The defaults are 1 item / 5%, 2 items / 15%, 3 items / 30%, and 5 items / 45%. Each tier's item count is adjustable from 1 to 20 and its discount from 0% to 90%.
What are the minimum and maximum quantities in a Pops Build-a-box?
Minimum quantity sets the lowest total items a customer can add to a box, from 1 to 19 (default 1). Maximum quantity sets the highest total, from 1 to 20 (default 3), and the quantity control caps each product at this value.
Why is the Add bundle to cart button disabled?
The Add bundle to cart button is disabled until a customer adds products to the box, so an empty bundle can't be submitted.
What does the Bundle summary show?
The Bundle summary lists Subtotal, Bundle discount, and Total, all starting at $0.00. Customers remove a line item with the Remove control.
Was this helpful?
Was this helpful?