Skip to main content
Use Product Quantity Rules 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 an indicator in the Self Service Center showing how many more items they need to add.
  • Maximum quantity — Orders are also blocked when the subscription goes over this number of products. The indicator in the Self Service Center shows when the customer needs to remove items.
  • Exact quantity — Set the minimum and maximum to the same number to require an exact box size, for example 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. Leave a value empty, or set it to 0, to disable that boundary.

​
Enable in New Features

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. In the Rules section, click Configure.
  4. In Item count requirement, set the minimum product quantity and/or maximum product quantity.
  5. Leave a value empty, or set it to 0, if you do not want to apply that limit.
  6. Click Save.
If you set both values, the maximum cannot be lower than the minimum.

​
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 an indicator on their subscription dashboard in the Self Service Center. This helps them understand whether their box is ready for the next order. The indicator shows:
  • How many products they currently have selected.
  • The target quantity they need to reach or stay within.
  • Whether their box is complete, below the minimum, or above the maximum.
For example:
  • If the minimum is 10 and the customer has 7 items, the indicator will show that they need to add 3 more items.
  • If the range is 4-12 and the customer has 13 items, the indicator will show that they need to remove 1 item.

​
Combining with other bundle features

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