Modifiers & Variants
What it does
Some items need choices before they go into the cart - a size, a sauce, extra cheese, a note for the kitchen. The Customize dialog is where you make those choices. It holds the quantity, the size, the options, the extras and the note in one place.
| Word | What it is | Example |
|---|---|---|
| Variant | A version of the item with its own price | Small, Medium, Large |
| Option | A choice from an option group, which can add to the price | Crust: Thin, Size: Large |
| Modifier | An extra or a change to how the item is made, which can add to the price | Extra cheese, no onion |
An item can have any mix of these, or none.
Customise an item
- Tap the item. The dialog opens with the title Customize and the item name.
- Set the quantity at the top of the dialog.
- If Select Option is shown, tap the size you want.
- Tap your choices in each group. A group marked with a red asterisk (*) is required.
- Enter any instructions in Add Note (Optional).
- Check the Price: at the bottom of the dialog.
- Tap Add To Cart.
Tap Cancel to close the dialog without adding the item.
What is in the dialog
| Part of the dialog | What it does |
|---|---|
| Quantity box | Tap − or +, or tap the number and enter a quantity |
| Quick: buttons | 0.25, 0.5 and 1 set the quantity. +0.25 and +0.50 add to it |
| Scale button | Reads the weight from the scale again. Shown for an item sold by weight when a scale is connected |
| Special Offer panel | Lists the offers that include this item. See Offers on an item |
| Select Option | The sizes of the item. Each tile shows the size name, its price and its unit |
| Option groups | Groups such as Size or Crust, each under its own name |
| Toppings & Add-ons | The heading above the modifier groups, shown when the item also has option groups |
| Modifier groups | Groups such as Sauces or Extras, each under its own name |
| Min: | Max: | The limits your manager set for a modifier group, shown on the right of the group name |
| Add Note (Optional) | A note for this item, up to 500 characters |
| Price: | The running price of the line |
How the groups work
| Type of group | How to use it |
|---|---|
| Required | Marked with a red asterisk (*). Select at least one choice, or the item cannot be added |
| Optional | Skip it if the customer wants nothing from it |
| Single-select | Tap a choice to select it. Tap a different choice to swap |
| Multi-select | Tap a choice to add one. A number badge and − and + buttons appear on the card. Tap + to add another |
A few details to know:
- In a single-select modifier group, tap the selected choice again to clear it.
- In a multi-select modifier group, the maximum counts every unit. Two lots of extra cheese count as two.
- In a multi-select option group, the maximum counts how many different choices you pick.
- Every choice shows its price with a plus sign. A free choice shows +$0.00.
Sizes and option groups
Your menu uses one of two ways to offer sizes and options. You will see one or the other on an item, never both.
| You see | How it works |
|---|---|
| Select Option with a tile for each size | Each tile shows the size name and its price, such as $18.00 / ea. One size is always selected. The default size is selected when the dialog opens |
| One or more named groups, such as Size or Crust | Each choice shows what it adds to the price, such as +$3.00. In a single-select group the default choice is selected when the dialog opens |
Choices that are greyed out
A choice with a diagonal line through it cannot be selected. It does not go with another option you have chosen. Change the other option first.
Add a one-off modifier
When an item has a modifier group named Misc, the group starts with a + tile. Use it for an extra that is not on the list.
- Tap the + tile in the Misc group. The Add Misc Modifier dialog opens.
- Enter the Modifier name, up to 30 characters.
- Enter the Modifier price.
- Tap Save.
The modifier appears as a tile in the group. Tap the tile to change it. Tap the bin icon on the tile to remove it.
In the cart, a one-off modifier shows as Misc_ followed by the name you entered.
Add or change a note
While adding the item: enter the note in Add Note (Optional) in the Customize dialog.
After the item is in the cart:
- Tap the line in the cart.
- Enter the note in Add Note (Optional).
- Tap Update Item.
The note shows under the item in the cart and prints with the item.
Change the options on an item in the cart
- Tap the line in the cart.
- Tap Edit Modifiers.
- If the line has a quantity above 1, the How Do You Want to Edit? dialog opens. Select one choice, then tap Edit Modifiers.
- Change the selections.
- Tap Update Modifiers.
- Tap Update Item.
The choices below are for a line with a quantity of 3.
| Choice in How Do You Want to Edit? | What it does | Saved when |
|---|---|---|
| Edit all 3 the same way | One set of modifiers applies to every unit on the line | You tap Update Item |
| Edit just 1 item differently | Splits one unit onto its own line with the new modifiers | You tap Update Modifiers |
| Choose how many to edit | Splits off the quantity you enter onto its own line | You tap Update Modifiers |
When you split a line, the item dialog closes by itself and step 6 is not needed.
Sent to the kitchen?
Once an item has been sent to the kitchen, the item dialog shows Item sent to kitchen (KOT) and Edit Modifiers is greyed out. Only the Split Payment Tag can still be changed. Add a new item instead.
Offers on an item
When an item is part of an offer, the dialog shows a panel headed 1 Special Offer, or the number of offers.
| You see | What it means |
|---|---|
| Auto tag | The offer applies by itself when the cart meets its conditions |
| A code on a button | Tap the code to copy it. The POS shows Copied to clipboard! |
| The offer row | Tap it to show or hide the Terms & Conditions |
See Coupons for how to apply a code.
The button changes with where you are
The button at the bottom right of the dialog has a different name in each place. It does the same job each time.
| Where you opened the dialog | Button |
|---|---|
| Adding an item to the cart | Add To Cart |
| Picking an item inside a combo deal | Add to Combo |
| Picking an item inside a BOGO or bundle deal | Add Item |
| Changing an item you already picked inside a deal | Update Item |
| Editing an item that is in the cart | Update Modifiers |
How the price is calculated
Line price = (item price + options + modifiers) × quantity
| Part of the price | Rule |
|---|---|
| Size under Select Option | The price of the size is the item price. It is not added on top of another price |
| Option from a named group | Its price is added to the item price |
| Modifier | Its price is multiplied by how many of it you chose, then added |
| Quantity | Multiplies everything - the item, its options and its modifiers |
| Free choice | Shows +$0.00 and adds nothing |
- Burger $10.00
- Size: Large +$3.00
- Extra Cheese $1.50 x 2+$3.00
- One burger $16.00
- Line total $16.00 x 2$32.00
The quantity multiplies the extras too, not only the burger.
For an item that uses Select Option, the size sets the starting price:
- Pizza - Large the price of the size$18.00
- Extra Cheese $1.50 x 1+$1.50
- Line total $19.50
A price that changes with another choice
Your manager can make a price depend on another choice. The dialog updates the prices on the tiles as you select.
| What changes | Example |
|---|---|
| A modifier, by size | Extra Cheese is $1.50. With Large selected it becomes $2.00 |
| An option, by another option | Gluten-free base is $2.00. With Large selected it becomes $3.00 |
Select the size first so the prices you read out are the right ones.
Part quantities
A quantity does not have to be a whole number.
| Price for one | Quantity | Line price |
|---|---|---|
| $16.00 | 0.5 | $8.00 |
| $16.00 | 1.25 | $20.00 |
Discounts
| Discount | What it comes off |
|---|---|
| An item discount your manager set up in the Admin portal | The item price only. Options and modifiers are charged in full |
| A discount you add to the line with Add Discount | The whole line, options and modifiers included |
See Discounts. For how the rest of the bill is built, see How the bill is calculated.
Rules and limits
| Rule | Limit |
|---|---|
| Note on an item | 500 characters |
| Name of a one-off modifier | 30 characters |
| Required group | At least one choice |
| Maximum in a group | Set by your manager in the Admin portal |
| Size under Select Option | Exactly one. Only sizes that are active are listed |
INFO
Modifiers, option groups, sizes and their prices are set up in the Admin portal. See Modifiers, Product Attributes and Variants.
Messages you may see
| Message | What it means / what to do |
|---|---|
| Select at least one modifier from the mandatory group "Sauces"! | A required modifier group is empty. Select a choice in the group named |
| All required variant options must be selected | A required option group is empty. Select a choice in every group with an asterisk |
| Max 2 modifier selection allowed. | The group is at its maximum. Remove a choice before you add another |
| Copied to clipboard! | You tapped an offer code and it was copied |
| Item sent to kitchen (KOT) | The item has gone to the kitchen and can no longer be changed |
FAQs
I tap Add To Cart and nothing happens. Why?
A required group is empty. The button is never greyed out - instead the POS shows a message naming the group and keeps the dialog open. Look for the group with a red asterisk and select a choice.
Why is an option greyed out with a line through it?
It does not go with another option you have selected. For example, a crust may not be offered in every size. Change the other option and it becomes available.
Why did the price of an extra change when I picked a larger size?
Your manager has set a different price for that extra on that size. The tile always shows the price for the size that is selected now.
Does a free modifier show a price?
Yes. It shows +$0.00.
Can I sell half of an item?
Yes. Tap 0.5 in the Quick: buttons, or enter the quantity yourself. The price is multiplied by the quantity, so half an item costs half as much.
Where do I add a kitchen note?
In Add Note (Optional). It is in the Customize dialog when you add the item. For an item already in the cart, tap the line, enter the note and tap Update Item.
An item with options was added without showing the dialog. Why?
Quick add when nothing is required is on and none of the item's groups is required. The item goes in with no options. To add some, tap the line in the cart and tap Edit Modifiers.
🔒 Manager only - change this in Settings → General → Ordering → Quick add when nothing is required. See General settings.
I edited the modifiers but the cart did not change.
After you tap Update Modifiers, tap Update Item as well. When you edit the whole line, the change is saved only when you tap Update Item.
Can I add modifiers to an item inside a deal?
Yes. The same dialog opens when you pick an item in a deal. See Deals for how the price is worked out there.
