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 Uses a Size Price from Its Item Reference

The example below shows a modifier group, Toppings, whose modifier options are individually priced. One of the modifier options in the Toppings group, Tomatoes, uses the SIZE_PRICE pricing strategy. Two sizes and prices are defined for Tomatoes, Small for $1.50 and Large for $3.50.

Sample JSON for a modifier option that inherits a Size Price from its item reference

{
  "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
                6,4
                ...
              ],
              ...
            }
          ]
        }
      ]
    }
  ],
  "modifierGroupReferences": {
    "7": {5
      "referenceId": 7,
      "name": "Size",
      "guid": "1517b7a4-612f-4447-ab93-46b989f01b6b",
      ...
      "pricingStrategy": "NONE",
      "pricingRules": null,
      ...
      "modifierOptionReferences": [
        20,6
        217
      ],
      ...
    },
    "6": {
      "referenceId": 6,
      "name": "Toppings",
      "guid": "a1778e92-7ce9-4b1e-867d-c1effd7478b8",
      ...
      "pricingStrategy": "NONE",8
      "pricingRules": null,
      ...
      "modifierOptionReferences": [
        19,9
        ...
      ],
      ...
    },
    "2": {10
      "referenceId": 2,
      "name": "Size",
      "guid": "23c02762-9d6a-4d3f-a298-71c989bf31b0",
      ...
      "pricingStrategy": "NONE",
      "pricingRules": null,
      ...
      "modifierOptionReferences": [
        12,11
        1312
      ],
      ...
    },
  "modifierOptionReferences": {
    "19": {13
      "referenceId": 19,
      "name": "Tomatoes",
      "guid": "b53cb945-d790-4386-88b5-c29b4f72141f",
      ...
      "price": null,
      "pricingStrategy": "SIZE_PRICE",14
      "pricingRules": {
        "timeSpecificPricingRules": [],
        "sizeSpecificPricingGuid": "1517b7a4-612f-4447-ab93-46b989f01b6b",15
        "sizeSequencePricingRules": []
      },
      ...
      "modifierGroupReferences": [
        716
      ]
    },
    "20": {
      "referenceId": 20,
      "name": "Small",17
      "guid": "e5c9883b-5c15-4771-9efa-0a63b9124484",
      ...
      "price": 1.5,
      "pricingStrategy": "BASE_PRICE",
      "pricingRules": null,
      ...
      "modifierGroupReferences": []
    },
    "21": {
      "referenceId": 21,
      "name": "Large",18
      "guid": "269cbff6-2e90-4ef8-8a83-ea5a76fb7199",
      ...
      "price": 3.5,
      "pricingStrategy": "BASE_PRICE",
      "pricingRules": null,
      ...
      "modifierGroupReferences": []
    },
    "12": {
      "referenceId": 12,
      "name": "Small",19
      "guid": "352244f2-a952-4a3a-a3ae-7775fa221ce7",
      ...
      "price": 8.0,
      "pricingStrategy": "BASE_PRICE",
      "pricingRules": null,
      ...
      "modifierGroupReferences": []
    },
    "13": {
      "referenceId": 13,
      "name": "Large",20
      "guid": "4ff89bca-b448-4892-bc4c-62c37a28ac44",
      ...
      "price": 10.0,
      "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 Size modifier group that defines sizes and prices for the Tomatoes modifier option.

6

Reference to the Small modifier option for the Tomatoes modifier option.

7

Reference to the Large modifier option for the Tomatoes modifier option.

8

Prices are defined on the modifier options themselves, so the pricingStrategy is NONE and pricingRules is null.

9

Reference to the Tomatoes modifier option.

10

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

11

Reference to the Small modifier option for the Cheese Pizza menu item.

12

Reference to the Large modifier option for the Cheese Pizza menu item.

13

The Tomatoes modifier option.

14

Indicates that the pricing strategy for the Tomatoes modifier option is SIZE_PRICE.

15

The GUID of the Size modifier group that defines sizes and prices for the Tomatoes modifier option. Note that this is the same modifier group that is referenced in the modifierGroupReferences map using the ID 7.

16

Reference to the Size modifier group that defines sizes and prices for the Tomatoes modifier option. This is the same modifier group whose GUID is specified in the sizeSpecificPricingGuid value.

17

The modifier option that defines the price of the Tomatoes modifier option when it is applied to a Small cheese pizza.

18

The modifier option that defines the price of the Tomatoes modifier option when it is applied to a Large cheese pizza.

19

The modifier option that defines the price of a Small cheese pizza.

20

The modifier option that defines the price of a Large cheese pizza.