This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Including default modifiers

A menu item can be configured with default modifiers. For example, a turkey sandwich menu item by default has lettuce and tomato modifiers.

When you use a Toast POS device to place an order, the Toast platform automatically adds the default modifiers on the selected menu items.

When you use the orders API to order an item that has default modifiers, default modifiers are not added automatically. You must include all of the default modifiers in the modifiers value for the item. If you omit a default modifier when you use the orders API, the Toast platform removes that modifier from the item. This means that if a guest requests that you remove a default modifier, then to satisfy the request, you can omit that modifier from the order JSON.

For example, for a pineapple and jalapeno pizza menu item, the default modifiers are cheese, pineapple, and jalapenos. To use the orders API to order the pineapple and jalapeno pizza, you must include all of those default modifiers in the modifiers value for the item. If a guest requests the pizza without jalapenos, you include only the cheese and pineapple modifiers. The Toast platform then specifies that the pizza should not have jalapenos.