How It Works
When you set a free modifier count on a modifier group:- The first N selections are free (no additional charge)
- Selections beyond the free limit are charged at their listed price
- Pricing updates automatically as customers add or remove selections
Example
A pizza withfreeModifiers: 3 on the “Extra Toppings” group:
| Selection | Price Charged |
|---|---|
| 1st topping (Pepperoni) | Free |
| 2nd topping (Mushrooms) | Free |
| 3rd topping (Olives) | Free |
| 4th topping (Extra Cheese) | £1.50 |
| 5th topping (Jalapeños) | £1.50 |
Setting Up Free Modifiers
This feature requires support to enable for your account. Contact support to request access.
- The modifier group name or ID
- The number of free selections to allow
Use Cases
Pizza Toppings
“Choose up to 3 toppings included, additional toppings £1.50 each”- Set
freeModifiers: 3on the toppings modifier group
Build-Your-Own Bowls
“Includes 4 ingredients, extras charged separately”- Set
freeModifiers: 4on the ingredients modifier group
Coffee Customisations
“First flavour shot free, additional shots 50p”- Set
freeModifiers: 1on the flavour shots modifier group
Salad Bar
“Choose 5 toppings with your salad”- Set
freeModifiers: 5on the toppings modifier group
POS Integration
Zonal (Aztec)
When importing menus from Zonal (Aztec), the “inclusive” count from choice groups is automatically mapped tofreeModifiers. If any modifier in the group has a supplemental price, the inclusive count is set to 0 (all selections are charged).
Pricing Logic
The system automatically applies free allocations to the most expensive selections first, ensuring customers always get the best deal:- All selected modifiers are sorted by price (highest first)
- Free allocations are applied starting with the most expensive items
- Cheaper items are charged if selections exceed the free limit
Example
WithfreeModifiers: 2 and these selections:
- Bacon (£2.00)
- Cheese (£1.50)
- Peppers (£0.50)
- Bacon: Free (most expensive)
- Cheese: Free (second most expensive)
- Peppers: £0.50 (charged)