How It Works
When a customer selects a modifier option that has nested modifiers attached, additional modifier groups appear below. If they change their selection, the nested groups update accordingly. Example: Build Your Burger- Customer sees “Choose your patty” with options: Beef, Chicken, Veggie
- Customer selects “Beef”
- A new modifier group appears: “How would you like it cooked?” with options: Rare, Medium, Well Done
- If customer changes to “Veggie”, the cooking preference disappears (not applicable)
Common Use Cases
Supported Integrations
Nested modifiers are supported when syncing menus from:- Deliverect
- Stream
- Toast
- Zonal Aztec
On a menu synced from a POS or menu management system, nested modifiers are configured there and sync automatically to storekit. On a menu you build in storekit, you attach them yourself — see Setting Up on a storekit-Built Menu.
Setting Up on a storekit-Built Menu
On a menu you build in storekit (not synced from a POS), a nested group needs two attachments before it appears on the ordering page:- It must be attached to the product, like any other modifier group.
- It must be assigned to the option that reveals it.
1
Create the nested group
Go to Menus, click Edit on the menu, click the product, and open the Modifiers tab of the Edit product panel. Create the group there (for example “Add extras”) with its options, minimum and maximum.
2
Attach the group to the product
Still in the product’s Modifiers tab, make sure the group is attached to the product — use Add a modifier group for a new one, or Use an existing group then Add group to product to attach a group that already exists. The group shows in the product’s modifier list like an ordinary group; the dashboard does not label it as nested.
3
Assign the group under the parent option
In the parent group (for example “Pick your half”), click Edit option (the pencil icon) on the option’s row to open its panel, go to the Sub-Modifiers tab, and add the group under Add a sub-modifier group. The Sub-Modifier Group column then lists it with its (minimum - maximum) range.
Nesting Depth
How many levels of nesting sync across depends on the integration.Customer Experience
Nested modifiers provide a cleaner checkout experience:- Customers only see relevant options based on their selections
- Reduces overwhelm from too many choices at once
- Guides customers through logical customisation steps
- Prevents invalid combinations (e.g., cooking preference for a veggie burger)
How Selections Are Handled
When a parent modifier selection changes:- Any nested modifier groups for the previous selection are hidden
- Selections in those hidden groups are cleared
- New nested modifier groups for the current selection appear
- Required nested modifiers must be completed before checkout
Why a product shows as sold out when its modifiers are unavailable
Not sure yet that modifiers are the cause? Item Not Showing on the Menu rules out the other reasons — snoozes, category hours, stock and menu settings — before you dig into modifier groups here.
What the customer sees
What happens on the ordering page depends on the menu’s Unavailable Product Options setting, because that is what decides whether unavailable options are still listed in the group:
A required group that has no options configured at all — for example a group that synced from the POS with none — behaves the same way.
How to spot it
1
Open the product's modifier groups
Go to Menus, click Edit on the menu, click the product, and open the Modifiers tab of the Edit product panel. Each row of the Group / Options table is a modifier group attached to this product; click Edit on a row to open the group.
2
Check whether the group is required
In the group, look under How many options can customers choose?. At least, Exactly and Between make the group required (a minimum of 1 or more); Any number and Up to are optional.
3
Check the options
Each row of the group’s table is an option with an In stock toggle. If every option is toggled off — or the table is empty and only + Add option is offered — a required group here cannot be satisfied, and the product is unavailable.
4
Work out which groups are nested
Nested groups appear in the product’s Modifiers list exactly like ordinary groups — the dashboard does not label a group as nested. To see the nesting, click Edit option (the pencil icon) on a modifier option’s row to open its panel and go to its Sub-Modifiers tab. The Sub-Modifier Group column lists the groups that option reveals, each with its (minimum - maximum) range; No sub-modifier groups added means the option reveals none.
On POS-managed menus, fix it in the POS
On a POS-managed menu (Deliverect, Toast, Zonal, Stream, Lightspeed K-Series, 3S POS) the modifier structure, each group’s minimum and each option’s availability all come from the POS, and every sync writes the POS values back over anything you change in storekit. So for a Toast menu delivered through Stream, make the change in Toast:- mark at least one option in the required nested group available again, or
- set that group’s minimum to 0 so it is no longer required, or
- restructure it as described below
- Stream and Deliverect push the menu when it is published in the source system. For Stream you can also click Sync menu in the row under the menu header to ask Stream to send it again. Deliverect has no sync button in storekit.
- Lightspeed K-Series and Toast menus have a Sync button, and Zonal a Sync menu button, in the row under the menu header (Menus → Edit). Sync all on the Menus page syncs every menu for one of these providers.
Prefer an optional standalone group to a required nested one
Where the nested choice is really part of an optional extra, model the extra as one optional group instead of an option that reveals a required group:
Keep required minimums for choices the customer must make about the product itself (size, base, cooking preference), not for add-ons.
Troubleshooting
Nested Modifiers Not Appearing
If nested modifiers aren’t showing, first check which kind of menu it is. On a storekit-built menu:- Check the nested group exists and is attached to the product: open the product’s Modifiers tab in the Edit product panel. If the group is not listed there, it cannot appear on the storefront — attach it with Use an existing group → Add group to product, even though it is a nested group.
- Check the group is also assigned under the option: click Edit option (the pencil icon) on the option’s row to open its panel, go to the Sub-Modifiers tab, and confirm the group is listed under Sub-Modifier Group. No sub-modifier groups added means the option reveals none.
- Check the nested group has available options and, if it is required (minimum 1 or more), that at least one option can satisfy it — a required nested group with no available options cannot be completed, so customers cannot add the item to their basket (see Why a product shows as sold out when its modifiers are unavailable).
- Verify your POS/menu system has nested modifiers configured correctly
- Check that the menu has synced recently
- Ensure you’re using a supported integration (Deliverect, Stream, Toast, or Zonal Aztec)
A Product Shows as Sold Out but Looks Available in the Dashboard
Check its required modifier groups, including nested ones — see Why a product shows as sold out when its modifiers are unavailable.Wrong Modifiers Showing
If incorrect nested modifiers appear:- Review the parent-child relationships in your POS system
- Re-sync your menu after making changes
- Check that modifier group IDs are correctly linked