Content Comparison

Info
Order-Level Content → Menu → Modifier Multiplier

Table of Contents

minLevel	1
maxLevel	6
outline	false
type	list
printable	false

Overview

What is a Modifier Multiplier?

Modifier Multipliers the options you can have for each of the ingredients that the brand allows to get modified in each item, they have a PLU related to each of them in a lot of cases but there might be POS exceptions.

These are what you might know as ingredients that are modifiable in each of our items like No Tomato (Sandwich), Regular Tomato (Sandwich), Extra Tomato (Sandwich), Regular Lettuce (Sandwich), Extra Sugar (Coffee), Light Milk (Coffee).

Modifier Multipliers are the options within a Modifier.

Note

Special Note for Modifiers

In the US and Canada, Modifiers will come from an automated sync from MDS. The team will have to create them in MDS before.

In international markets we used to but now they will be created with the set up process provided below.

Tip
If you are not in the USA or Canada, this guide is for you!

...

Editing Modifier Multipliers

Modifier

In this space you will link the corresponding Modifier. For example, if you are creating the Modifier Multiplier for No Tomato, you will link the Tomato Modifier.

Tip
You need to have already created the Modifier previously

...

Region

Note
This field is only applicable for USA and Canada, where Modifiers and Modifier Multipliers are synchronized from MDS

Vendor Configs

Tip
Your POS will have a different PLU for all the different options.

...

For each Service Mode Group (Pickup and Delivery), you will need to configure the correct PLU.

...

Prefix

This is the name of the selection that the customer will see, associated to the multiplier that you will define right after.

...

Multiplier

Info
This is necessary for the system to calculate nutrition for your modfiers multipliers correctly and for the backend of the application to understand the build of each item.

...

Tip
The key question: is the modifier you are configuring divisible in halves or whole / indivisible?

Channel Exclusions

Need to show different items depending on the Service Mode Group (Pickup / Delivery) or the platform (Web, Mobile, Kiosk, Google Food Ordering)? This is the place where you can exclude items from being shown to the guests.

...

Modifier Controls

Info

You arrive here by clicking on the Options in the Item document, as seen below.

We found out it was easier and effortless for our teams to maintain the options of each items in this section, rather than in the Modifier or Modifier Multiplier documents.

...

Modifier Type	Rules / Acceptance Criteria
Boolean/checkbox	itemOption has two options with modifierMultipliers 0 and 1 `singleChoiceOnly` = false Grouped by display group, use as headers in Customize section Ignore: `displayModifierMultiplierName` itemOption `min` and `max`- always 0 and 1
Non-numeric range	`singleChoiceOnly` = false `displayModifierMultiplierName` = true Use modifier multiplier prefix to display quantity Grouped by display group, use as headers in Customize section If no prefixes (for all or only some of the quantity options), default to using modifier multiplier numbers for all values. There shouldn’t be a mix of prefixes and numbers. Ignore: itemOption `min` and `max`- always 0 and 1
Numeric range	`singleChoiceOnly` = false `displayModifierMultiplierName` = false Use modifier multiplier number to display quantity Grouped by display group, use as headers in Customize section Ignore: itemOption `min` and `max`- always 0 and 1
Select one from options	itemOption `max` = 1 `singleChoiceOnly` = true No display group, use modifier group name from MDM as header Ignore: `displayModifierMultiplierName`
Select multiple from options	itemOption `max` > 1 `singleChoiceOnly` = true No display group, use modifier group name from MDM as header Sub-header to indicate max number of selections: “Choose x {modifierGroup}” Use same wording/Lokalise key as cart add-ons max Since we will default users to x number of selections, all + should be disabled and they should have to decrement the selection they don’t want in order to enable the + on other selections Ignore: `displayModifierMultiplierName`

Steps to Disable a Modifier Multiplier for a Certain Restaurant:

Remove the PLUs for the modifier multiplier that you don't want any more from the restaurant PLUs list.
Toggle the "Inject Default Selection" for the modifier in Sanity if the default value is not the one that should be available. (read below for explanation)
Turn the enable-hide-modifier-multipliers flag ON.

...

Note: If the modifier has a default modifier multiplier it will always be included in the list of options (regardless if it is available on the restaurant or not) unless the "Inject Default Selection" toggle is turned on in Sanity. Here is the logic in the code that always marks a MM as available if it is the default one: https://github.com/rbilabs/ctg-whitelabel-app/blob/master/workspaces/frontend/src/utils/availability/index.ts#L271-L275