Option Groups
Option groups let you add modifiers to menu items , from size selections and add-ons to customizations , with optional price adjustments.
Overview
An option group contains a set of options that a customer can choose from when ordering an item. Each group has rules about how many options can be selected.
Examples:
- Size: Small ($0), Medium ($2), Large ($4) , radio, required, select exactly 1
- Toppings: Extra Cheese ($1.50), Bacon ($2), Guacamole ($2.50) , multi-select, select up to 3
- Side: Fries ($0), Salad ($0), Coleslaw ($0) , radio, optional, select 0–1
Group Properties
| Property | Type | Description |
name | string | Display name of the option group |
min_select | number | Minimum number of options the customer must select |
max_select | number | Maximum number of options the customer can select |
required | boolean | Whether at least one option must be selected |
display_order | number | Sort position of this group among other groups |
Selection Behavior
| min_select | max_select | required | Behavior |
| 0 | 1 | false | Optional single choice (radio, can skip) |
| 1 | 1 | true | Required single choice (radio, must pick one) |
| 0 | N | false | Optional multi-select (checkboxes) |
| 1 | N | true | Required multi-select (must pick at least one) |
Option Properties
| Property | Type | Description |
name | string | Display name of the option |
price_delta | number | Additional cost (or discount) applied when this option is selected |
is_default | boolean | Whether this option is pre-selected |
display_order | number | Sort position of this option within the group |
Managing Option Groups
Option groups are created and managed from the Menu Item editor.
Adding an Option Group to an Item
- Open the menu editor and go to the Menu Items tab.
- Create a new item or edit an existing one.
- Scroll to the Option Groups section in the item form.
- Click Add Option Group.
- Configure the group:
- Enter a group name (e.g. "Size", "Extra Toppings")
- Set min/max select values
- Toggle Required on/off
- Add options to the group:
- Enter an option name (e.g. "Medium", "Extra Cheese")
- Set a price delta (positive for upcharge, negative for discount, 0 for free)
- Toggle Default if this should be pre-selected
- Drag options to reorder them within the group.
- Click Save on the item.
Editing Option Groups
- Click the edit pencil on an existing option group in the item form.
- Modify group settings or individual options.
- Use the trash icon to remove individual options or entire groups.
Price Calculation
The item's total price is calculated as:
```
Total = Base Price + Sum of all selected option price deltas
```
For example:
- Base price: $10.00
- Selected: Large (+$4.00) + Extra Cheese (+$1.50)
- Total: $15.50
Display on Public Menu
On the public menu:
- Radio groups (max_select = 1) appear as a list of selectable options with a single choice.
- Multi-select groups (max_select > 1) appear as checkboxes.
- Required groups are clearly indicated to the customer.
- The running total updates as options are selected.