Skip to content

Modifier Lists

Create reusable Modifier Lists, configure auto-import filters and pricing, preview matching variations, and attach lists to items.

2 min readintermediateFull Crunch

Who is this article for?

Managers and team members who build sellable menu items

Create a reusable Modifier List for choices such as toppings, sizes or extras. Attach the finished list to the menu or hybrid items that should offer it.

Create the List

1
Open Modifier Lists and choose Create Modifier List.
2
Enter a Name, optional Description and Status.
3
Set Required, Minimum Selections and Maximum Selections.
4
Add modifier options, or save the list and add them from its detail page.

Use custom or item-based modifiers according to whether an option should consume stock. Check selection rules before making a list required.

Add Auto-Import Rules

Auto-import rules create item-based modifiers from matching catalog variations.

  1. Open the saved list and, under Auto-Import Rules, choose Add Rule.
  2. Name the rule and set at least one filter: Tags, Item Types, Sale Price Range or Cost Per Item (CPI) Range.
  3. Set Price Adjustment. This fixed adjustment supplies the default for newly imported modifiers; it is not the item's base sell price. Negative adjustments can represent discounts.
  4. For new options that should consume a specific quantity, set Amount Adjustment and Unit of Measure. Units must be compatible with the linked inventory.
  5. Choose Enabled and whether to use Auto-Sync, then choose Create Rule.

Filter groups work together. Within Tags, an item matching any selected tag qualifies. Sale-price filtering checks variation prices; CPI filtering can match inventory at any location. A CPI match does not restrict the modifier to that location. Minimum values must not exceed maximum values.

Preview and Sync

Expand the saved rule and choose Preview Matching Items. Check the matching variations, New, Existing, compatible and skipped counts, calculated price adjustment and any unit-conversion warning. The preview can show a limited sample, so check its total matching count too.

Disabled demo Menu-item import rule with Auto-Sync off and a preview of 57 matching compatible items View larger
Preview before importing. This demo rule is disabled, Auto-Sync is off, and its 57 matching items have not been imported by the rule.

Choose Sync Now to apply the rule and review the result. Sync can add matching options or remove rule-generated options that no longer match or have incompatible units. An option already present manually or through another rule can be skipped instead of duplicated.

Rule pricing and quantity settings are defaults for new imports. Existing imported options keep their price and quantity edits, so review those options separately after changing the rule. With Auto-Sync enabled, an enabled rule responds to catalog item creation, updates and deletion. Recheck the preview after changing filters or units.

Attach the List to Items

Open a menu or hybrid item and use its Modifier Lists card. One list can serve multiple items, and an item can use multiple lists. Importing options into a list does not itself attach that list to sellable items.

Attach and reuse Modifier Lists Choose a modifier type and consumption quantity

Did this guide help?

Can’t find the answer?

Tell the support team what you’re trying to do and where you’re getting stuck.

Contact support