Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firmhouse.com/llms.txt

Use this file to discover all available pages before exploring further.

Use the Plan Product Quantity Range feature to enforce a minimum and/or maximum number of products on a subscription plan. When a subscription’s total product quantity falls outside the configured range, Firmhouse will skip regular order generation until the customer adjusts their selection. This is ideal for box builder propositions where customers must fill their box with an exact number of items before an order can be processed — for example, a meal box that requires exactly 8 meals, or a smoothie bundle that needs at least 10 sachets.

​
How it works

When you configure a minimum and/or maximum product quantity on a plan:
  • Minimum quantity — Orders will not be generated until the customer has at least this many products in their subscription. The customer sees a progress indicator in the Self Service Center showing how many more items they need to add.
  • Maximum quantity — Customers cannot exceed this number of products. The progress indicator will show when they are over the limit.
  • Exact quantity — Set the minimum and maximum to the same number to require an exact box size (e.g. exactly 8 meals per week).
When the product quantity is outside the configured range, the regular order generation is skipped and the shipment dates are shifted forward automatically. As soon as the customer brings the quantity back into range, the next order will proceed as normal.

​
Enable the Plan Product Quantity Range feature

Note: This is a preview feature that is currently staff-only. Please reach out to Firmhouse sales or support to have this feature enabled on your project.
Once enabled by the Firmhouse team, you will see the quantity range fields when editing a plan.

​
Configure the quantity range on a plan

  1. In the Firmhouse Portal, go to Plans from the sidebar.
  2. Open the plan you want to configure, or create a new one.
  3. Scroll to the Product Quantity Range section.
  4. Set the Minimum product quantity — the minimum number of products a customer must have for an order to be generated.
  5. Set the Maximum product quantity — the maximum number of products allowed. Set to 0 for no upper limit.
  6. Click Save.

​
Example configurations

  • Exact box of 8: Set both minimum and maximum to 8. The customer must have exactly 8 products.
  • At least 10, no maximum: Set minimum to 10 and maximum to 0. The customer needs at least 10 products, but can add more.
  • Between 4 and 12: Set minimum to 4 and maximum to 12. The customer has flexibility within a range.

​
Customer experience in the Self Service Center

When this feature is enabled, customers see a progress bar on their subscription dashboard in the Self Service Center. This progress bar shows:
  • How many products they currently have selected.
  • The target quantity they need to reach (or stay within).
  • A visual indicator of whether their box is complete (green), below minimum (amber), or above maximum (red).
This gives customers a clear and intuitive way to understand whether their box is ready to ship.

​
Combining with other bundle features

Plan Product Quantity Range works well in combination with: See the Bundles & Boxes overview for more details on combining these features.