Skip to main content
A bundle or box builder proposition lets your customers compose their own recurring box by picking individual items from your catalog. This model is popular with food, drinks, health, and lifestyle brands where customers want variety and control over what they receive each cycle. Some examples of how merchants use Firmhouse to power bundle and box propositions:
  • A freeze-dried smoothie brand where customers choose a pack size (e.g. 10, 20, 30, or 60 sachets), pick their favorite flavors, and subscribe for recurring deliveries at a lower per-unit price.
  • A meal prep service where customers select how many meals they want per week (e.g. 4 to 20), choose their dishes from a weekly rotating menu, and must lock in their selection by Tuesday. Their box is then delivered the following Monday. This uses Firmhouse’s Billing Cutoff & Delivery Anchors to enforce the weekly deadline and fixed delivery day.

​
Key features for bundles & boxes

Firmhouse offers three features that you can use individually or combine to build a complete box builder experience:
FeatureWhat it does
Tiered DiscountsAutomatically increases the discount when customers add more items to their subscription.
Plan Product Quantity RangeEnforces a minimum and/or maximum number of products per subscription, ensuring customers fill their box before an order is generated.
Billing Cutoff & Delivery AnchorsSets fixed delivery dates and a deadline for customers to finalize their box selection.

​
Combining the features

Each of these features can be used independently, but they become especially powerful when combined. Here are a few common setups:

​
Volume-discounted box

Combine Tiered Discounts with Plan Product Quantity Range to let customers build a box where:
  • The more items they add, the cheaper each item becomes (tiered discounts).
  • A minimum quantity ensures the box is worth shipping, and an optional maximum prevents over-ordering (quantity range).
For example, a smoothie brand could offer 10% off for 10+ items, 15% off for 20+ items, and 20% off for 30+ items, while requiring at least 10 items per box.

​
Fixed weekly meal box

Combine Plan Product Quantity Range with Billing Cutoff & Delivery Anchors to create a weekly box where:
  • Customers must select exactly the right number of items for their plan (e.g. 8 meals per week).
  • Orders are only generated when the box is complete.
  • A cutoff date (e.g. Wednesday) gives customers until that day to finalize their selection before the box ships on a fixed delivery day (e.g. Monday).

​
Full box builder

Use all three features together for the most complete setup:
  • Tiered Discounts reward customers who choose larger boxes.
  • Plan Product Quantity Range enforces the box size rules.
  • Billing Cutoff & Delivery Anchors gives customers a window to curate their selection before each delivery.

​
How Firmhouse handles bundles

It is important to understand that Firmhouse does not work with a virtual bundle parent product the way some other subscription solutions do. Instead, Firmhouse manages bundle sizes at the Plan level — each individual component of the bundle must be added to the cart and subscription as its own product with the appropriate selling plan. This means:
  • The plan defines the rules (minimum/maximum quantity, discounts, delivery schedule).
  • Each item the customer picks is a separate product in the Shopify cart and in the Firmhouse subscription.
  • Firmhouse checks whether the total number of individual products meets the plan’s quantity requirements before generating an order.
You can still add a parent “box” product to the cart for cosmetic purposes (e.g. to show a single “Weekly Meal Box” line item), but for Firmhouse to correctly manage the subscription, every individual bundle component must be added to the cart with the correct selling plan attached.

​
Building a bundle picker on your Shopify storefront

Firmhouse does not currently offer a theme extension or bundle builder UI out of the box. However, developers can build a custom “pick & bundle” experience directly on the Shopify storefront. Here is a recommended approach:
  1. Create a dedicated product template — Set up a specific product page template in your Shopify theme for a virtual bundle product. This product represents the box that customers will fill.
  2. Show a product listing grid — On that product page, display all available items the customer can pick from (e.g. a grid of meals, smoothies, or snacks). For time-based propositions like meal boxes, this could be presented as a calendar or weekly menu.
  3. Add items to a temporary bundle cart — Let customers add individual items to a temporary on-page bundle cart. Show the selected items and quantities so customers can review their picks before adding to the Shopify cart.
  4. Add to Shopify cart in one call — Offer an “Add to cart” button that adds all chosen items to the Shopify cart in a single API call, each with the appropriate selling plan attached. This ensures all products are linked to the correct subscription plan.
  5. Show a progress bar (optional) — If you are using Plan Product Quantity Range, consider building a progress bar that shows how many items the customer still needs to add to meet the minimum quantity, similar to the one Firmhouse displays in the Self Service Center.
This approach gives you full control over the look and feel of the bundle builder while Firmhouse handles the subscription logic, billing, and order generation on the back end.

​
Getting started

Follow the detailed guides below to enable and configure each feature:
  1. Tiered Discounts — Set up quantity-based automatic discounts that increase as customers add more products.
  2. Fixed Bundle Sizes (Plan Product Quantity Range) — Configure minimum and maximum product quantities on a plan to enforce box sizes.
  3. Billing Cutoff & Delivery Anchors — Set fixed delivery dates and cutoff deadlines for subscription selections.