What is Build-a-Box?
Build-a-Box allows customers to create their own product bundle by selecting items from a predefined list.
Customers must select the required number of items (e.g. 3 or 6 items) before they can add the box to their cart.
Once all rules are met, Subi automatically applies the configured discount.
What Build-a-Box Supports
One-time purchases
Subscription purchases
Percentage discounts
Fixed amount discounts
Who Should Use Build-a-Box?
For Merchants
Use Build-a-Box if you want to offer:
Custom product bundles
Subscription boxes
Flexible promotional kits
For Customers
Customers can:
Build their own product box
Choose from a curated product list
Subscribe to recurring bundles
Step 1: Create a Build-a-Box Plan in Subi
Go to your Subi Dashboard
Go to Plans (Subscription Plans page)
Click Create Plan
Select Build a box
Plan Configuration
1. Plan Details
Plan title → Name of the bundle
Plan description → Internal or display description
2. Product Pool (How to add products)
You can add products to the box in two ways:
By Collection → Select a collection to include all its products
Manual Selection → Select specific products individually
✅ Important:Customers can only choose products from this pool.
3. Box Options
Define how many items customers must select.
Examples:
Box of 3 items
Box of 6 items
⚠️ Customers must select exactly this number before adding to cart.
4. Discount Settings
Choose how the discount is applied:
Percentage discount
Fixed discount amount
Each box option can have its own discount.
5. Subscription Settings
Configure subscription behavior:
Set subscription frequency
Configure subscription discount rules
⚠️ This step is required if subscription purchase is enabled
6. Purchase Type
Choose how customers can buy:
One-time purchase
Subscription
Both
7. Save the Plan
After saving, Subi generates a Box ID.
You will need this ID to display the widget on your storefront.
Step 2: Add the Build-a-Box Widget to Shopify
Creating the plan does NOT automatically display it on your store.
You must manually add the widget.
How to Add the Widget
Copy the Box ID from Subi
Go to Shopify Admin → Online Store → Themes
Click Edit theme
Navigate to the section where you want the widget
Click Add block
Select Apps
Click Build box widget (Subi Subscriptions)
In the right-side panel → Enter the Box ID
Click Save
Customer Experience
On your storefront, customers will:
Open the Build-a-Box section
Select a box size
Choose frequency
Choose products from the available pool
Add items until the required quantity is reached
Add the box to cart
⚠️ The discount is applied only when all rules are satisfied
How Build-a-Box Discounts Work
Discounts apply per box, not per cart
Each box is validated independently
Multiple boxes can exist in one cart
Each box is identified using:
_build_box_id
When a Discount Is Applied
A discount is applied only when all conditions are met:
Validation Rules
All items use the same box option (
_build_box_option_id)Purchase type is consistent (subscription or one-time)
Total quantity matches the box size
All products belong to the product pool
Discount Types Explained
One-Time Purchase (Percentage)
Applied to all items in the box
One-Time Purchase (Fixed)
Distributed across items (not shown as one discount line)
Subscription Discounts
Applied in this order:
Build-a-Box discount
Subscription discount
⚠️ Discounts are applied sequentially, not combined.
Troubleshooting
Build-a-Box Widget Not Showing
Check:
The widget block is added to the theme
The correct Box ID is entered
Theme changes are saved
Most common issue: Missing or incorrect Box ID
Discount Looks Incorrect
Fixed Discounts
Distributed across items, not shown as one value
Subscription Discounts
Applied in sequence, which affects final pricing
Need Help?
Live Chat → Available in Subi or on the website
Email → [email protected]