Nutrition & Allergen Information Management
Correctly managing Nutrition & Allergen information across our platforms is essential for informing our guests and ensuring a compliant business.
- 2 Capabilities for the New European Nutrition & Allergen Legislation
- 2.1 1. Displaying Price per unit (litre, & kg) in Menu view
- 2.2 2. Info text related to Deposit price for Combo items
- 2.3 3. Deposit price mentioned for single drink items (excluding combo items with drinks)
- 2.4 4. Modifier nutrition and allergen info pop-up modal
- 2.5 5. PDP page nutrition and allergen (N&A) pop-up modal updated view
Source of Truth for Nutrition & Allergens
The way Nutrition & Allergens information is managed across different markets and brands of RBI is not uniform. Depending on the operations and/or various other reasons, a brand/market could opt for one of the following options as the source of truth:
1) MDS (Master Data System)
For most markets and RBI brands, Food Quality Assurance and Innovation teams use MDS to create and approve new products or Limited Time Offers, approve suppliers, and connect each ingredient to the main product. The end result is that the master database holds information regarding the quantities (grams) of each ingredient used in a product, getting its nutrition and allergens centrally recorded.
The information from MDS is then automatically synced into Sanity on a daily-basis and the Nutrition & Allergen fields in Sanity become populated. These fields are not editable in Sanity in this option since MDS is the source of truth. The menu sync mentioned here is legacy, please reach out to your CSM to turn it off and enable full edition rights in Sanity.
2) Sanity
There are two ways N&A information could be managed in Sanity:
Via the Nutrition Fields Populated within Sanity Item pages
Via a Static File/Web Page
To configure either option, please reach out to your Customer Success contact.
The guest experience difference between these two options could be seen below:
Nutrition Fields Populated within Sanity
A Static File / Web Page
2-a) Nutrition Fields Populated within Sanity Documents
Nutrition & allergen information is displayed in Sanity documents as follows:
The Nutrition section in Sanity (for example available in the Item documents) refers to nutrition information for the product alone, whereas Nutrition with Modifiers refer to the nutrition with the pre-selected modifiers.
Since the source of truth is Sanity, operators are able to directly edit the values in these fields in Sanity.
2-b) A Static File / Web Page
As an alternative to filling in the Nutrition fields in Sanity, operators could opt for uploading a static file and/or a web page to display the nutrition & allergen information to the guests.
The Calorie
field under the Marketing Content → Features → Feature Disclaimer page is used to add the following section:
The static file could be configured under Marketing Content → Static Pages within Sanity by providing a re-direct URL, please contact your CSM to support with the setup.
The Feature Nutrition Widget
The Feature Nutrition widget in Sanity enables the content teams to manage what nutritional fields are displayed in the whitelabel application (under the Nutrition & Allergen modal), as well as the order those fields are displayed. It is found under Marketing Content → Features → Feature Nutrition within Sanity.
The Feature Nutrition widget can only be used with the manually edited N&A fields in Sanity (not when the Static File / Web Page option is used for displaying N&A information) in the whitelabel application.
Each nutrition & allergen value that is desired to be displayed in the whitelabel application should be added to the tables within the Feature Nutrition widget with their Nutrition Key (e.g. calories, fat, sodium):
The configuration above will reflect as follows within the whitelabel application:
The widget allows users to also group nutrition values, add translations and has rounding rules that control whether and how the values are rounded.
The widget display options are configured at a market-level, it is not possible to determine a custom list of values or ordering at a product-level.
Please reach out to your CSM to enable the LD flags in Production and Staging for your brand as explained in Feature Nutrition .
Once the Feature Nutrition is enabled, then the nutritional & allergen information in the whitelabel application becomes read as-is from Sanity based on the values in the Feature Nutrition widget. That is, rounding of values and conversions (e.g. kJ, per 100g) are not performed automatically by whitelabel, but are managed and read directly from the Feature Nutrition widget.
When Feature Nutrition is enabled, the Nutrition Keys which are not added under the Items section will not display in the whitelabel application. Additionally, the fields that are not added won’t be modifiable via the Nutrition and Nutrition with Modifier sections in Sanity documents.
Markets utilizing the Feature Nutrition Widget for displaying nutritional values can choose whether or not to display the unit of value beside the number. Below is an example where units are attached both to the nutritional item’s description and its value. To display units in descriptions, these must be manually entered in Sanity (e.g. "Fett (g)" or "Brennwert (kJ / kcal)").
To omit units from values, select "Omit Unit from Value" under Marketing Content → Features - Feature Nutrition → Edit Nutrition Item. This change allows for greater flexibility and control over what is displayed in the description, without automatically displaying units next to values on the whitelabel platform:
Product Size
The configuration option Product Size has been added to Sanity to indicate the serving size together with the nutrition values. This feature is valuable for markets where the serving size is legally required to be shared.
Capabilities for the New European Nutrition & Allergen Legislation
These capabilities help address legal requirements in some markets.
1. Displaying Price per unit (litre, & kg) in Menu view
This feature enables content managers to display the price per unit—such as per litre or per kilogram—for any item listed in the menu view and product description page (PDP) on the live site.
Menu view on the live site with price per unit (l or kg )
|
---|
Steps to follow to get the price per unit for any item
1.1. How to Add Size and Unit Information in Sanity
Log in to Sanity.
Navigate to the Item:
Go to Menu-> item then select the desired item.Locate the Fields:
Scroll to the bottom of the item details to find the two fields:Size
Unit
Enter the Values:
Size represents the weight or volume of the item.
For solid items, enter the size in kilograms (kg) , if kilogram price of the item is to be displayed
For liquid items, enter the size in litres (l), if litre price of the item is to be displayed
If content author wants to display prices per 100 ml or per 100 grams then appropriate value has to be entered in field Size.
Example Scenarios:
Scenario A: Display price per kilogram (kg)
If the item size is 25 ml and the price is 60 cents:
Convert 25 ml to liters: 25 ml = 0.025 liters (or kg if it's a weight-based item).
Enter: 0.025 in the Size field.
Scenario B: Display price per 100 ml
If the item size is 25 ml:
25 ml is 0.25 of 100 ml.
Enter : 0.25 in the Size field.
Use the following values for the Unit field:
l : for liquid items
kg for solid food items
The unit field is a free text box. Whatever info is added in the field will be reflected in the website. Content authors can also add text “per 100 ml“ for certain products as per their requirement. Below is the screenshot of “per 100 ml“
Example:
For a liquid item like Coca-Cola (500 ml), enter:Size:
0.5
Unit:
l
Publish the Changes:
After entering the size and unit details, click Publish to apply the updates.Result:
Once published, the price per unit (l or kg) will be visible in both the Menu View and the Product Detail Page (PDP) view.
It is important to ensure that unit pricing details are entered only for the relevant items. Incorrectly associating these details with the wrong item will result in inaccurate information being displayed publicly on the live site.
2. Info text related to Deposit price for Combo items
This feature enables content managers to display any relevant product-related information. The text can include details such as the deposit value or any other pertinent content. Only available for menu picker and menu combo items
Info text seen for menu picker items on menu and product description view (PDP) on the live site
|
|
---|
Steps to follow to get the info text on Menu and PDP view for any menu picker item
2.1. How to Add Price Detail Text in Sanity for a menu picker item
Log in to Sanity.
Navigate to the Item:
Go to Menu-> Menu picker then select the desired item.Locate the Field:
Scroll down to find the “Price Detail Text” field.Enter the Information:
This is an alphanumeric field, meaning it accepts both text and numbers.
Enter the relevant details you want to display alongside the item price.
Publish the Changes:
After entering the information, click Publish to apply the updates.Result:
The entered text will appear below the item price in both the Menu View and the Product Detail Page (PDP) view on the live site.Follow the same steps for items under menu combo to add deposit text to it
3. Deposit price mentioned for single drink items (excluding combo items with drinks)
This feature separates the Pfand (deposit) value from the base price of individual drink items.
Previously, the Pfand amount was included in the total drink price. Now, the drink price is displayed exclusive of the Pfand, which is shown as a distinct value. This update applies only to standalone drink items and does not affect combo items that include drinks
|
|
---|
Below changes franchise have to make in Sanity to exclude price from pfand
3.1. How to Configure Deposit Price Exclusion in Sanity
Log in to Sanity.
Navigate to:
Menu->Menu configuration → Deposit price exclusionAdd a New Item:
On the Deposit Price Exclusion page, click “Add Item.”Search for the Pfand Item:
Use the keyword “pfand” in the search bar.Select the Correct Item:
Choose the Pfand item that has Multiplier set to 1.Publish the Changes:
Click Publish to apply the configuration.Result:
Once published, the Pfand label will be displayed on the live website, and the drink price will be shown excluding the Pfand amount.
4. Modifier nutrition and allergen info pop-up modal
This feature enables content managers to input Nutrition & Allergen (N&A) information for modifiers multiplier, which will then be displayed on the Product Detail Page (PDP).
|
|
---|
4.1. How to nutrition and allergen details to modifier multiplier in Sanity
Log in to Sanity.
Navigate to the Item:
Go to Menu-> modifier multiplier then select the desired item.
Locate the Field:
Scroll down to find the “Nutrition” field.
Fill in the carbohydrates, fat, and other nutritional details
Scroll below to find “Allergen” fields
Fill in the allergen data
Publish the Changes:
Click Publish to apply the configuration.
Result:
Once published, the nutrition and allergen details for the modifier multiplier will be seen in PDP page of the combo and picker items they are associated with
Modifier additional info text box
There is an additional info richtextbox seen under modifier document , this can be used to add additional lnfo for a modifier, which will be applicable to all modifier multipliers attached to that modifier
If nutrition and allergen (N&A) information is provided for a modifier multiplier, an information (‘i’) icon will appear on the Product Detail Page (PDP) for that modifier multiplier. When users click the icon, a pop-up will display the corresponding N&A details.
“I” icon is displayed if there is either allergen or nutrition information is added in modifier multipliers document
If no N&A information is entered for a modifier multiplier, the ‘i’ icon will not be shown, and the information will remain hidden. Therefore, content managers should ensure that relevant N&A details are added for all applicable modifiers multipliers.
Nutrition and allergen information in item options modifiers will not be considered, only N&A from modifier multiplier document will be considered . We are going to migrate existing N&A data from item options modifier to modifier multiplier document . After migration, care should be taken not to update item option modifier N&A as it would not show up in the whitelabel live website. Going ahead modifier multiplier document will be the source of truth.
5. PDP page nutrition and allergen (N&A) pop-up modal updated view
"As part of this feature, the Nutrition & Allergen (N&A) modal pop-up will follow an updated display order.
Additionally, to support both current and future N&A requirements, two rich text fields have been introduced in Sanity. These fields enable content managers to add or update information independently, without relying on the engineering team."
Steps to update information in Rich text box in Sanity
Sanity and white label Rich text box mapping
5.1. Steps to Add Additional Item Information in Sanity
Log in to Sanity.
Navigate to:
Menu->Item-> Select the desired itemAccess Item Details:
Once the item details are visible, scroll to the “Additional Item Information” section.Expand the Section:
Open the “Additional Item Information” section and locate the field titled “Additional Information Block 1”.Enter Content in Block 1:
This is a rich text field.
Content entered here will appear in the Nutrition & Allergen (N&A) modal on the Product Detail Page (PDP) of the live site.
Specifically, it will be displayed just below the product name in the “Additional Info” section of the modal.
Use this space to include important details such as warnings, alcohol content, or other relevant product information.
(Refer to the N&A modal video for visual guidance.)
Enter Content in Block 2:
Located just below Block 1, “Additional Information Block 2” is also a rich text field.
Content added here will appear directly beneath the “Allergen Information” subsection in the N&A modal.
This space is ideal for preparation and storage instructions, manufacturer details, and other supporting information.
Publish Changes:
After entering the required information, click “Publish” to make the updates visible on the live site.
5.2. Option available in rich text box field for adding details
Three options are available in rich text box to add the fields
# | Options for adding field | Explanation |
---|---|---|
1 | Title with horizontal rule | To add a field which a horizontal rule/ divider below it : Example: A horizontal divider is positioned below the “product description” field. Content managers should utilize this “Title with horizontal rule“ to add relevant fields, ensuring consistency in layout and presentation. The content “The peppercorn collection ….“ should be added below the field
|
2 | Table row | To add a field which does not need a horizontal rule below it . This option also allow to add values to the field entered . Example: The 'Product Weight' and 'Alcohol Content' fields do not include a horizontal divider beneath them. Therefore, content managers should use this specific “table row“ option to add such fields appropriately. If we add values like 407g seen for product weight it will be shown as well, or else it will be empty and not seen in live website
|
3 | Text with icon | To add text with icon such as cross mark or check mark. Example: In this image in order to add the field additives, content manager should use the title with horizontal rule and for each additives like with color or with nitrate should make use of the field text with icon
|
4 | Editing, & deleting the fields | All fields added to the rich text box, can be edited and deleted. Every fields has 3 dots (ellipses) upon clicking it, you get the edit and remove option Also the fields can be dragged and rearranged in order
|
Based on the above explanation and the steps outlined, three recommended versions of Nutrition & Allergen (N&A) configurations can be implemented. Each version differs in the structure of the 'Additive' section, allowing for flexibility based on specific content and presentation needs.
The color of the checkmark and crossmark will not be green and red, but it will be BK brand color.
Additive section with cross, & check mark icon list | Additive section with bullet points | Additive section with regular text |
---|---|---|
|
|
|
The order in which fields are added within the rich text box determines the order in which they will appear on the live website. Content managers should carefully arrange the fields based on the desired display sequence.
Additionally, it is important to select the correct field type. Fields configured with a 'rule' will be displayed differently from those using a 'table row' format. Choosing the appropriate type ensures the content is presented as intended
"The two rich text fields are made available under Items in Sanity and can be accessed via Menu Combo / Menu picker as well (wherever the item has been linked to).