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.

Modifier Option that Inherits a Sequence Price from a Modifier Group

When using sequence pricing, the cost of a modifier option depends on the order in which it is added to a menu item. For example, on a pizza menu item, the first topping is free, the second topping costs $1.00, the third topping costs $1.50, and all additional toppings cost $2.00. As modifier options are added to or removed from the menu item, the cost of the menu item is updated to reflect those choices.

Unlike the Size Price and Size/Sequence Price pricing strategies, the Sequence Price pricing strategy has no interaction with the pricing strategy of the menu item that a modifier option is applied to. In the example below, the Cheese Pizza menu item has two sizes, Small ($8) and Large ($10). The first topping added to either size costs $1, the second topping costs $2, and all additional toppings cost $2.50. So, a small Cheese Pizza with two toppings costs $11 while a large Cheese Pizza with two toppings costs $13.

Sample JSON for modifier options that inherit Sequence pricing from a parent modifier group

{
  "restaurantGuid": "2071fb81-988b-4d75-b8dc-c5c17cff9706",
  ...
  "menus": [
    {
      "name": "Dinner",
      "guid": "ddd681de-3c12-4d45-b8b1-a5b2ea898210",
      ...
      "menuGroups": [
        {
          "name": "Pizza",
          "guid": "dc868006-919a-4950-a4cc-3a03f9770fd7",
          ...
          "menuItems": [
            {
              "name": "Cheese Pizza",
              "guid": "95c5d500-8d92-46f2-bec4-fb2a42a46621",
              ...
              "price": null,
              "pricingStrategy": "SIZE_PRICE",1
              "pricingRules": {
                "timeSpecificPricingRules": [],
                "sizeSpecificPricingGuid": "23c02762-9d6a-4d3f-a298-71c989bf31b0",2
                "sizeSequencePricingRules": []
              },
              ...
              "modifierGroupReferences": [
                2,3
                4,4
                ...
              ],
              ...
            }
          ]
        }
      ]
    }
  ],
  "modifierGroupReferences": {
    ...
    "4": {
      "referenceId": 4,
      "name": "Toppings",5
      "guid": "2fb9889a-e3e9-4039-9bbd-99defb7f04b1",
      ...
      "pricingStrategy": "SEQUENCE_PRICE",6
      "pricingRules": {
        "timeSpecificPricingRules": [],
        "sizeSpecificPricingGuid": null,
        "sizeSequencePricingRules": [
          {
            "sizeName": null,
            "sizeGuid": null,
            "sequencePrices": [
              {
                "sequence": 1,
                "price": 1.07
              },
              {
                "sequence": 2,
                "price": 2.08
              },
              {
                "sequence": 3,
                "price": 2.59
              }
            ]
          }
        ]
      },
      ...
      "modifierOptionReferences": [
        14,10
        1511
      ],
      ...
    },
    "2": {12
      "referenceId": 2,
      "name": "Size",
      "guid": "23c02762-9d6a-4d3f-a298-71c989bf31b0",
      ...
      "pricingStrategy": "NONE",
      "pricingRules": null,
      ...
      "modifierOptionReferences": [
        12,13
        1314
      ],
      ...
    },
  },
  "modifierOptionReferences": {
    ...
    "14": {
      "referenceId": 14,
      "name": "Pepperoni",
      "guid": "11adaad3-c391-42e8-a234-350a16e5a68d",
      ...
      "price": null,
      "pricingStrategy": "GROUP_PRICE",15
      "pricingRules": null,
      ...
      "modifierGroupReferences": []
    },
    "15": {
      "referenceId": 15,
      "name": "Sausage",
      "guid": "bd3a44ed-8362-49b8-8f6e-c899480137ff",
      ...
      "price": null,
      "pricingStrategy": "GROUP_PRICE",
      "pricingRules": null,
      ...
      "modifierGroupReferences": []
    },
    ...
    "12": {
      "referenceId": 12,
      "name": "Small",
      "guid": "352244f2-a952-4a3a-a3ae-7775fa221ce7",
      ...
      "price": 8.0,16
      "pricingStrategy": "BASE_PRICE",
      "pricingRules": null,
      ...
      "modifierGroupReferences": []
    },
    "13": {
      "referenceId": 13,
      "name": "Large",
      "guid": "4ff89bca-b448-4892-bc4c-62c37a28ac44",
      ...
      "price": 10.0,17
      "pricingStrategy": "BASE_PRICE",
      "pricingRules": null,
      ...
      "modifierGroupReferences": []
    }
  }
}

1

Indicates that the pricing strategy for the Cheese Pizza menu item is SIZE_PRICE.

2

The GUID of the Size modifier group that defines the sizes and prices for Cheese Pizza menu item. Note that this is the same modifier group that is referenced in the modifierGroupReferences map using the ID 2.

3

Reference to the Size modifier group in the modifierGroupReferences map. This is the same modifier group whose GUID is specified in the sizeSpecificPricingGuid value.

4

Reference to the Toppings modifier group.

5

The Toppings modifier group.

6

Indicates that the pricing strategy for the Toppings modifier group is SEQUENCE_PRICE.

7

The price of the first topping added to the Cheese Pizza menu item ($1).

8

The price of the second topping added to the Cheese Pizza menu item ($2).

9

The price of the third topping added to the Cheese Pizza menu item ($2.50). Because this is the last price in the sequence, it is also the price of any toppings added beyond the third.

10

Reference to the Pepperoni modifier option.

11

Reference to the Sausage modifier option.

12

The Size modifier group that defines sizes for the Cheese Pizza menu item.

13

Reference to the Small modifier option.

14

Reference to the Large modifier option.

15

GROUP_PRICE indicates that the Pepperoni modifier option inherits its price from its parent modifier group.

16

A Small cheese pizza costs $8.

17

A Large cheese pizza costs $10.