Menu item groups let you bundle menu items together with selection rules — perfect for meal deals, set menus, and combo packages. With per-item quantity, your customers can now choose how many of each item they want within a group, rather than just picking one of each.
This is ideal for any scenario where a customer selects from a group and may want multiples of the same item — like choosing 6 donuts from 4 available flavors, or picking 3 sides from a list of 8.
When should I use this?
Per-item quantity is useful whenever your menu has bundled selections where customers may want more than one of the same item. Some common examples:
Use case | Example setup |
Box of donuts | "Pick exactly 6" with max 3 per flavor |
Meal deal sides | "Choose 2 sides" — customer can pick 2x fries |
Dim sum platter | "Select between 4–8 items" with max 2 of each |
Build-your-own pizza | "Pick up to 5 toppings" — double pepperoni allowed |
Drinks package | "Choose 3 drinks" with max 2 per type |
How to set it up
Step 1: Open your menu item group
Navigate to Settings → Base Menu → Menu Item Groups. Either create a new menu item group or edit an existing one.
Step 2: Configure the selection rules
Under the Rules section, you have two modes:
Required — the customer must select items. Choose either:
Exactly — a fixed number (e.g. exactly 6)
Between — a range (e.g. between 2 and 5)
Optional — the customer can select items but doesn't have to. Set a Maximum total items to cap the selection.
Step 3: Set the maximum quantity per item
Once your total selection count is greater than 1, a new field appears: Maximum quantity per item.
This controls how many times a customer can select the same item within the group. For example:
If your group requires exactly 6 items and you set max quantity per item to 3, a customer could choose 3 Chocolate + 2 Strawberry + 1 Vanilla.
If you leave it blank, there is no per-item limit — a customer could select all 6 of the same flavor.
Step 4: Save
Click Save. The changes take effect immediately across all linked menus and channels.
‼️ Changes are applied instantly to all menus and channels using this menu item group — no need to republish.
How it works for your customers
When per-item quantity is enabled, your customers will see quantity controls (+ / − buttons) next to each item in the group, instead of simple checkboxes. This makes it intuitive for them to select multiples.
The total count is enforced automatically — once they reach the maximum, the + buttons are disabled. If a per-item max is set, individual items are also capped.
This works in both the customer ordering app (QR code ordering) and the merchant POS (when staff place orders on behalf of customers).
How it appears on receipts and tickets
Items with a quantity greater than 1 are printed with a quantity prefix. For example:
Donut Box
3x Chocolate Donut
2x Strawberry Donut
1x Vanilla Donut
This keeps your kitchen tickets clear and accurate, so staff know exactly how many of each item to prepare.
Note: Items with different quantities or sub-selections are always shown as separate lines — they are never incorrectly combined on receipts.
Pricing
If items in the group have individual prices, the quantity is reflected correctly in the order total. For example, if French fries cost ฿50 and a customer selects 2x, they are charged ฿100 for the fries.
Frequently asked questions
What happens if I don't set a per-item maximum?
Customers can allocate their entire selection to a single item. For example, in a "Pick 6" group, they could choose 6 of the same flavor. This is fine for many use cases.
Can I use this with the "Optional" rule?
Yes. Set the Maximum total items to more than 1 under the Optional rule, and the per-item quantity field will appear.
Does this work with existing menu item groups?
Yes. You can edit any existing menu item group and add the per-item quantity setting. It won't affect groups where you don't set it.
Is this the same as option group quantity?
Similar concept, different scope. Option groups are modifiers attached to a single menu item (e.g. toppings on a pizza). Menu item groups bundle entire menu items together (e.g. the pizzas themselves in a meal deal). Both support per-item quantity, but they are configured in different places.