The total item count answers “how many items complete the box?” A per-variant repeat limit answers “how many of this one item can be selected?” Keeping those rules separate makes the offer easier to explain and test.
The quantities below are fictional examples, not recommendations or proof of a store’s selling eligibility.
Distinguish items from distinct variants
An illustrative six-item box can contain six different variants, or fewer distinct variants with repeats. A rule of six items does not, by itself, require six different products.
If your intended offer requires no repeats, use the available per-variant limits accordingly and test the result. Do not describe “six different items” if the configured experience permits two of the same variant.
Work through a valid selection
Suppose a fictional box requires six items and allows at most two of each candidate variant.
| Selected variant | Quantity |
|---|---|
| Sample berry snack | 2 |
| Sample oat snack | 2 |
| Sample cocoa snack | 1 |
| Sample nut snack | 1 |
This selection totals six, and no variant exceeds two. A total of five is incomplete. A total of six that includes three of the berry variant breaks the repeat rule even though the overall count is correct.
Make sure the candidate pool can satisfy the rules
Look at the combination of available candidates and repeat limits. Three candidates limited to one each cannot complete a six-item box. Adding more unavailable products does not solve a selection problem.
Treat this as a planning check, then review the actual configuration and inventory readiness. Availability can change between browsing and checkout; a count that looks possible on paper is not a guarantee of stock.
Test the edges
- Select fewer than the required total.
- Reach the exact total.
- Try to exceed the total.
- Try to exceed one variant’s repeat limit.
- Remove an item after completing the selection.
- Change a variant’s availability and verify the reported behavior.
The picker should explain what is missing or blocked. The server and checkout path must also enforce the relevant rules; text on the page is not an enforcement mechanism.
Keep the language consistent
Use the same count and repeat wording in the product description and picker. Distinguish the selection’s progress from an error. “Two items remaining” helps a shopper complete a box; an inventory problem needs its own explanation.
After changing the count, candidate pool, limit or price, follow the supported pause-and-publish workflow. Do not assume a new configuration should silently reinterpret an older cart selection.
Connect rules to the purchase path
Test the completed box in the cart and the supported edit flow. Check the actual variant quantities, not just the box heading. If a problem appears, record the visible error and check the selected quantities, current availability and cart result before retrying.
For a broader configuration sequence, read how to plan a fixed-price box.
See a gift box in action
Try the sample picker with fictional products. It creates no cart or order.
Try the box builder