Restaurant
Item modifiers
Required / optional groups, size variants, add-ons.
Modifiers let diners customize an item before adding it to their bag — pick a size, add toppings, choose a cooking temperature. Every modifier belongs to a modifier group, and each group has rules about how many choices a diner can pick.
When to use modifiers
- Size variants — "Size: Regular / Large +$2"
- Required choices — "Bun: Brioche / Sesame / Lettuce wrap" (diner must pick one)
- Add-ons — "Toppings: Bacon +$2 / Avocado +$1.50 / Extra cheese +$1" (diner picks zero or more)
- Cooking temperature — "Doneness: Medium / Medium well / Well done"
If you're bundling multiple items at one price (burger + side + drink), use Combo meals instead — modifiers are for customizing a single item.
How modifier groups work
A modifier group has 4 rules:
- Required — must the diner pick something to add the item to their bag?
- Min selections — minimum number of choices (usually 1 for required, 0 for optional)
- Max selections — maximum number of choices
- Multi-select — can the diner pick more than one option? (e.g. toppings = yes; size = no)
How to do it
Step 1 — Open an item
From Stores → your store → Menu, click into the item you want to customize. Scroll to the Modifier Groups section.
Step 2 — Add a modifier group
Tap + Add group. Give it a clear name like "Size" or "Add-ons". Set required/min/max based on what you need:
- Size — Required ✓ · Min 1 · Max 1 · Multi-select ✗
- Add-ons — Required ✗ · Min 0 · Max 4 · Multi-select ✓
- Doneness — Required ✓ · Min 1 · Max 1 · Multi-select ✗
Step 3 — Add options to the group
Inside the group, add each choice with its name and price delta. Price delta is added to the base item price when the diner picks it:
- Regular → +$0.00
- Large → +$2.00
- Bacon → +$2.00
- Avocado → +$1.50
Mark one option as default to pre-select it for diners. They can still change it.
What the diner sees
When a diner taps an item with modifier groups, the bottom-sheet detail modal shows:
- The base price at top
- Each modifier group as a section
- Required groups marked with a red asterisk
- Live-updating total at the bottom — adds modifier deltas as the diner picks
The Add to bag button is disabled until all required groups have valid selections.
Order matters. Modifier groups appear in the same order you create them. Put the most-important choice first (size before toppings before doneness). Drag the grip handle on the left of each group to reorder.
Modifiers vs Choice Groups
A common point of confusion: modifiers belong to ONE item. If you have the same set of choices across multiple items, you'll be re-creating them every time.
If that's your case, look at Choice Groups — they're reusable pools that you build once and combos reference. The downside is they only work inside combos, not on standalone items.