Modifier Groups

Modifier Groups are the groupings that Ingredients or Selections belong to (i.e.: The modifiers ‘Chicken,’ ‘Steak,’ and ‘Tofu’ may belong to the modifier group ‘Proteins’). If a customer is given a choice between several options for their item, these options would be ingredients within a modifier group. Items can have an unlimited number of modifier groups but we recommend using no more than 5 per item to speed up order flow.

Common Modifiers are a way to create modifier groups so that multiple items can share the same modifier group.

Nested Modifiers are a type of modifier group that allows customers to make a choice within a choice.

Common Modifiers

To access the common modifier page:

1. Log in to the GRUBBRR backend with company or branch credentials
   • Use whichever is the level you have previously been creating your menu on
2. Select ‘Menu’ from the left sidebar menu
3. Select ‘Modifier Management’ from the dropdown
4. Select ‘Common Modifiers’ from the dropdown

Creating Common Modifiers

From this page, you can add new common modifiers by selecting ‘+Add New’ in the upper right corner. If you add a selection you are creating a nested modifier. When you want to create a nested modifier, follow the steps shown below and read the 'Nested Modifiers' section of this article.

Required steps:

1. Enter a Modifier Group Name into the Modifier Name field
   • Modifier group names can be repetitive, you may have 6 variations of 'Choose Your Toppings' so it will help to have unique modifier group names
   • Examples: Pasta - Choose Your Sauce, Toppings (Chicken Sandwich), Soups: Add Ingredients
2. Enter a Modifier Group Display Name into the Display Name field
   • Examples: Choose Your Sauce, Proteins, Add Toppings
3. Enter a value into the Display Order field
   • This number determines what order the modifier groups show in for each item they are mapped to (1 is first, 2 is second, etc.)
4. Enter a value into the Minimum Selection field
   • If you want to require a modifier group, this value must be 1 or greater
5. Enter a value into the Maximum Selection field
   • This defaults to 1, if you want customers to be able to choose more options enter a greater value
6. Add an Ingredient or Selection in the Ingredients column of the table at the bottom of the screen
   • The (I) is for ingredients; the (S) is for selections
   • If you add a selection you will not see it unless you create a nested modifier, for more information on the difference scroll down to the Nested Modifiers section of this article or read the Ingredients and Selections article
7. Enter a price into the extra price field if the ingredient has an upcharge
   • This price will not show unless the Premium flag is checked (step 10)
8. If customers can add more than one of the ingredient, enter a maximum amount to select into the Max Qty field
   • The default is 0 which does not allow customers to control individual ingredient quantity
9. If you want the ingredient to always be default selected, check the Default box
10. If you entered a price into the extra price field, check the Premium box
11. Hit the '+' button under the 'Action' column
    • If you do not press this the ingredient will not be added to the modifier group
12. Repeat steps 6 - 11 for all ingredients and selections you wish to add
13. Select 'Save'

---

Additional Options:

• KOT/KDS Display Name
  • Name modifier group displays as on KOT/KDS
• External Reference ID
  • If your menu was imported through a third-party integration, each item, ingredient, and modifier group will import with an external reference ID
  • This field is irrelevant to non-integrated accounts
• Enable Color Coded Modifiers
  • Changes the color of the ingredients on POS and KDS

Mapping Common Modifiers

Once you create a modifier group, you have to assign it to the necessary items. When you finish adding a new modifier group you will be taken back to the modifier group master list.

To map a modifier group:

1. Locate the modifier group from the list
   • From the GRUBBRR backend, you will be in Menu > Catalog Management > Common Modifiers
2. Select the Items Mapping icon (list on a blue background) in the top right corner of the group
3. Select all items you want this variation group to be associated with
   • You can set item-specific Display Order by editing that value here
4. Select 'Save'

Nested Modifiers

Nested modifiers are modifier groups within modifier groups or choices within choices. Ingredients are the options you choose in a modifier group, Selections are modifiers that trigger an additional modifier group (they act as a gateway modifier). Nested modifiers, like regular modifier groups, also have Ingredients. Selections are only used as gateway modifiers, every modifier that does not trigger an additional choice is an Ingredient.

For example, if you had a modifier group ‘Additional Toppings,’ your ingredients might be ‘Lettuce,’ ‘Cheese,’ and ‘Tomatoes.’ In addition to these ingredients, you might have a selection called ‘Extra Protein.’ That selection could be made up of the ingredients ‘Chicken,’ ‘Steak,’ and ‘Tofu.’ This is a nested modifier.

Below you will find an example of how nested modifiers operate within the kiosk.

Creating Nested Modifiers

Nested modifiers are made similarly to common modifier groups. To make a nested modifier you have to add at least one selection to your modifier group. After you complete your initial modifier group and select ‘Save,’ return to the ‘Common Modifier’ page and look for your newly created modifier group.

Your common modifier group will appear in a table format with its ingredients and selections listed individually by row. In the row where your selection is located, there will be a pencil icon. Select this to create your nested modifier.

The nested modifier creation screen is the exact same as the normal modifier group creation screen. Make any necessary edits to the minimum and maximum quantity, then add your ingredients.

Once you finish adding ingredients, select 'Save.'