Nutrition & Allergen Information Management
- Yildirim, Semih
Correctly managing Nutrition & Allergen information across our platforms is essential for informing our guests and ensuring a compliant business.
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 [DEPRECATED] 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.
The Nutrition Explorer
The Nutrition Explorer is a feature enabling the brands to highlight the nutritional information for the menu items in a dynamic way via a separate page while providing the users with the ability to gather additional information that might not be easily visible within the menu.
The capability also includes a pre-determined set of filters to enable the guests to easily search for various choices. We expect these filters to improve conversion for guests - especially those with specific dietary preferences. The guest experience could be seen below:
To enable the Nutrition Explorer page, contact your CSM to configure the LD Flags enableNutritionExplorer as true, and if you’d like the allergens to also display configure theenable-nutrition-explorer-allergens as true.