All Collections
Lunchbox 1.0
LB 1.0 Integrations
LB 1.0 Toast Documentation
(LB 1.0) Native Ordering - Menu Configuration (Toast)
(LB 1.0) Native Ordering - Menu Configuration (Toast)
Updated over a week ago

Native Ordering - Menu Configuration - Toast:

Lunchbox Menus are pulled into the Admin Dashboard through two types of Manual Menu Syncing: Initial Menu Syncs, and Subsequent Menu Syncs, both of which do not require Lunchbox support to execute.

Initial Menu Syncs Include:

This is the first time that Lunchbox pulls your menu into the Lunchbox Admin Dashboard. It is important to make sure that your menu items are set up properly before pulling this sync.

NOTE: Importing Multiple Menus is supported through the Toast and Lunchbox integration.

NOTE: The Toast Online orders: Checkboxes have no affect on Menus that are imported to Lunchbox. All menus import with or without this checkbox.

Screen_Shot_2022-08-09_at_10.04.10_AM.png

Menus:

  • Name, Location Availability, Menu Groups within the Menu *Priority will appear as it does from the Toast Ordering Screen

Menu Groups:

  • Name, Description & Location Availability, Menu Items within the group *Priority will appear as it does from the Toast Ordering Screen

Menu Option Groups:

  • Name, Min, Max & Location Availability, Menu Modifier Options and Modifiers within the group. *Priority will appear as it does from the Toast Ordering Screen

Menu Items:

  • Name, Price, Calories, Description, Image URL, Location Availability, *Priority will appear as it does from the Toast Ordering Screen & Inventory/Item Qty, (Only when this is enabled on the Admin Dashboard on the item level.) Menu Modifier Groups and Modifiers within the group.

Menu Modifiers:

Name, Price, Calories, Description, Image URL & Location Availability, Modifier Ordering Priority, Menu Modifier Groups and Modifiers within those groups. *Priority will appear as it does from the Toast Ordering Screen, Modifier Required Min Max & Inventory/Item Qty (Only when this is enabled on the Admin Dashboard on the item level).

  1. Images URL’s only come through on the first import. Click here for Image Sizing Requirements.

  2. Menu Taxes are not imported these are validated at checkout.

  3. Duplicate Modifiers setting is not currently imported into the Lunchbox Admin Dashboard for Modifier Groups. See the picture below.

Screen_Shot_2022-02-20_at_1.30.35_PM.png

This setting must be manually set up in the admin dashboard by locating the modifier group and checking off the This option can be selected once per item check box.

Screen_Shot_2022-02-20_at_1.31.06_PM.png

Subsequent Menu Syncs Include:

Subsequent menu syncs are any Syncs placed after the initial onboarding phase. These include new and previously imported menus, modifiers and items. Please read the following list of settings included in each of these syncs.

Menus:

  • New Menus - Name, Menu Groups & Location Availability, Menu Item Groups within the Menu *Priority will appear as it does from the Toast Ordering Screen

  • Previously Imported Menus - Location Availability, *Priority will appear as it does from the Toast Ordering Screen unless overridden on the admin dashboard

Menu Item Groups:

  • New Menu Item Group - Name, Description & Location Availability, Menu Items within the group *Priority will appear as it does from the Toast Ordering Screen

  • Previously Imported Menu Item Group - Location Availability, *Priority will appear as it does from the Toast Ordering Screen unless overridden on the admin dashboard

Menu Option Groups:

  • New Menu Option Groups - Name, Min, Max & Location Availability, Menu Modifier Options and Modifiers within the group. *Priority will appear as it does from the Toast Ordering Screen

  • Previously Imported Menu Option Groups - Min, Max & Location Availability, *Priority will appear as it does from the Toast Ordering Screen unless over ridden on the admin dashboard

Menu Items:

  • New Menu Items - Name, Price, Calories, Description, Image URL, Location Availability, *Priority will appear as it does from the Toast Ordering Screen & Inventory/Item Qty, (Only when this is enabled on the Admin Dashboard on the item level.) Menu Modifier Groups and Modifiers within the group.

  • Previously Imported Menu Items - Price, Location Availability, *Priority will appear as it does from the Toast Ordering Screen unless overridden on the admin dashboard, Inventory/Item Qty (Only when this is enabled on the Admin Dashboard on the item level).

Menu Modifiers:

  • New Menu Modifiers - Name, Price, Calories, Description, Image URL & Location Availability, Modifier Ordering Priority, Menu Modifier Groups and Modifiers within those groups. *Priority will appear as it does from the Toast Ordering Screen, Modifier Required Min Max & Inventory/Item Qty (Only when this is enabled on the Admin Dashboard on the item level).

  • Previously Imported Menu Modifiers - Price, Location Availability, *Priority will appear as it does from the Toast Ordering Screen unless overridden on the admin dash, Modifier Required & Min Max, Inventory/Item Qty (Only when this is enabled on the Admin Dashboard on the item level.)

Menu Building Rules:

The following is a list of menu-related rules that must be adhered to on the Toast Admin Dashboard before doing the initial menu sync. There are a few Rules when configuring the menu in order to make sure it communicates properly with Lunchbox. Make sure to read through all of these carefully before proceeding to edit or build your menu.

RULE 1: Price It Right - Toast Menu & Modifier Pricing Limitations

Supported Toast Pricing Structures - Base Price, Location-Specific Price

Screen_Shot_2022-02-22_at_3.38.09_PM.png

Unsupported Toast Pricing Structures - Menu Based, Open Price, Time Specific Price, Sequence Price, Size Price, Inherited Modifier Price, Overridden Location Based Price

NOTE: Menu Items should never be based on these pricing structures on the item level, on the restaurant group level, or through some sort of inherited functionality. These types of menu pricing are not yet supported and Lunchbox will assume the highest pricing when the item imports. Lunchbox will always pull the highest price on GUIDs. See screenshots below.

Screen_Shot_2022-02-22_at_3.38.50_PM.png

WE DO NOT SUPPORT MENU GROUP PRICING INHERITANCE

Screen_Shot_2022-02-22_at_3.44.14_PM.png

WE DO NOT SUPPORT MODIFIER PRICING INHERITANCE

Screen_Shot_2022-02-22_at_3.56.28_PM.png

Size Pricing Alternative - We recommend using a modifier group called size with modifiers named the corresponding size with a base price set per size modifier. Benefit this allows you to maintain the same GUID per size and ingredient type. Size pricing generates multiple GUIDs that are not replicated when used on a like ingredient modifier.

Modifier Specific Pricing Limitations - Adjusting prices through price inheriting (or on the outside layer of modifiers or via modifier groups) to keep item GUID’s the same for depletion purposes is not yet supported and Lunchbox will show an incorrect price during the ordering process.

Modifier Sequence Pricing Alternative - We recommend using two separate groups, free options in the first group, and limiting the amount that can be ordered in the group. Then create a second group with additional charges. The GUIDs will have to be separate for all of those options to support the pricing change.

RULE 2: Don’t Create Redundancy

Don’t have a nested modifier reference an item that contains the parent modifier. (it creates a circular reference) For example do not nest a side of fries with the same GUID (Nested/Parent Modifier) nested inside of a side of fries with the same GUID (Parent Modifier).

RULE 3: Subgroup Limitations

Don't do 2 layers deep of subgroups, which means that you don’t put a subgroup inside of a subgroup. If you do by default Lunchbox drops the parent subgroup and just flattens both into one.

Example:

→ Drinks

→ → Cold Drinks

→ → Hot Drinks

Becomes just:

→ Cold Drinks

→ Hot Drinks

Subgroups can be turned on as an item should you need to have them visible on the Lunchbox Ordering Screen (you can see this in Sticky's and Wings Over). A special request would need to be made through your CSM or Delivery Manager.

RULE 4: Image Sizing Requirements

It is important that menu images be uploaded in the proper format. If images aren’t uploaded properly, it can cause resolution problems, scaling issues, and delayed image loading times. Please follow these guidelines carefully:

Menu Item Images

Size: 1280x720px; landscape (16:9) ratio
File: JPG recommended or PNG
160kb or smaller

Menu Modifier Images

Size: 100x100px; square (1:1) ratio
File: PNG
160kb or smaller

RULE 5: Target Your Menus, Items and Modifiers Properly

Menu Items should be owned and targeted to the parent restaurant group in order to ensure that all locations have visibility. The three restaurant groups listed below are examples of how to limit menu visibility:

  • Parent Group/All Locations Target - Includes all restaurants. This means all restaurants will have access to this Menu or Menu Item.

  • Region Group Target - Includes restaurants within a specific region.

  • Location Specific Target - This will allow one restaurant to see this menu item.

NOTE: When you want to limit visibility on an item, the Owner needs to be set to the parent restaurant group and the target needs to be set to the subgroup, which should be added to the Parent Restaurant Group in the restaurant group section of Toast to ensure visibility.

Screen_Shot_2022-02-20_at_1.34.18_PM.png

RULE 6: Copying Menu Items & Modifiers

Toast has two ways to copy Menu Groups, Items and Modifiers: Copy & Deep Copy.

  • Copy: Refers to when the item is copied and a separate GUID has been created for that new item or modifier. Make sure all of your functionality settings have been set and they will copy over to the new menu item of modifier on Toast as well.

  • Deep Copy: Refers to when the item is copied and a separate GUID has been created for that new item or modifier as well as all items groups and modifiers nested within that item as well.

Screen_Shot_2022-02-20_at_1.35.03_PM.png

Deep Copies are made when the Make Deep Copy Checkbox has been checked. This is most typically used for copying modifiers without nested modifiers inside of them to ensure the external & internal layer of the modifier are copied.

Screen_Shot_2022-07-01_at_10.43.40_AM.png

WARNING: This is not recommended for Menu Groups with Items Inside, Menu Items with Modifiers and nested modifiers, Modifier Groups With Modifiers with nested modifiers. Don’t use Deep Copy unless you intend to make a copy of every item and modifier nested below the group or item! Selecting Deep Copy will create a copy of the selected Menu Groups and any items, subgroups, modifier groups, and modifiers it contains. Any changes made to these copies will not impact the originals.

Always double-check where your targets are when copying menu items, modifiers.

RULE 7: Maintain Fewer GUID for Depletion & 86ing

When building your menu for simplified depletion and 86ing purposes it is important to try and maintain a small number of GUIDs on like items. (Example a modifier group containing a side portion of fries that is also sold as an item should have the guid across both the side item and the side item built as a modifier.)

NOTE: Exceptions include price changes and portion changes unless you are using an external party to interpret the information into your inventory system. These instances are required to have separate GUIDs and will have to be manually toggled off across multiple GUIDs.

NOTE: When nesting items as modifiers inside of modifier groups within an item, it is important that, any layers nested below that item built as a modifier not have any additional items as modifiers nested below them. Second layers of modifiers should be modifiers only.

(Example: I want to sell popular additions on an item. So I add a brownie item as a modifier. Any modifiers nested below the brownie cannot have items as modifiers they must be modifiers only.) The only way that Lunchbox can process a request like this is if all modifiers in the second popular additions group are modifiers not items as modifiers.

Item

>Modifier Group

>>Item As Modifier

>>>Modifier Group

>>>>Modifiers Only

Screen_Shot_2022-06-19_at_10.38.53_AM.png

RULE 8: Finish Your Menu on Toast and Be Thorough

Make sure your menu is finalized in Toast before pulling the initial sync following all of the aforementioned rules and you should be all set to go and ready to sync!

Screen_Shot_2022-02-20_at_1.35.03_PM.png

For a full detail on how to build out the Menu on Toast check out the Toast article below:

RULE 9: Sync It Before You Sink It!

Before pulling a menu sync, remember to publish the menu to all locations and then request that Lunchbox pull a menu sync through the Support icon located on your Admin Dashboard. If you do not do this, it will cause the menu sync to fail and settings to not reflect properly on the Admin Dashboard.

  1. This must be done every time that a round of menu changes are made without exception.

  2. Make sure not to toggle settings on the Admin Dashboard during menu syncs. This can cause syncs to fail.

  3. Marketplace clients must request that Lunchbox Pull a Menu Sync for all locations!

Did this answer your question?