arrow-left Back to Announcements
DATE:
AUTHOR:
The Toast - API team
Configuration API Menus API Objects, fields, and values

New enumerated values for the unitOfMeasure value in the menus and configuration APIs

DATE:
AUTHOR: The Toast - API team

On 2026-04-27, the MenuItem and ModifierOption objects in the menus API will include new enumerated values for the unitOfMeasure value. The Menu, MenuGroup, and MenuItem objects in the configuration API will also include the new enumerated values for their unitOfMeasure values. The unitOfMeasure value indicates the unit of measure used to weigh, determine size, or otherwise quantify menu items or modifiers.

The new values represent volume and length units and include:

  • GAL: Gallons

  • L: Liters

  • ML: Milliliters

  • FL_OZ: Fluid ounces

  • M: Meters

  • CM: Centimeters

  • FT: Feet

  • IN: Inches

  • YD: Yards

Make sure your configuration and menus API integrations will handle new unitOfMeasure values before they appear in API response data on 2026-04-27. For more information about the menus and configuration APIs, see the API reference documentation.

Note

Your integration should handle unexpected values in any Toast API enumerated value without disrupting operations.

Like all changes to the menus API, the new enumerated values for unitOfMeasure become available in the menu JSON after a restaurant has made a menus-related change and published the new menu, which initiates regeneration of the restaurant's menus data. For more information, see Menus API returns published data only.

This change applies to both V2 and V3 of the menus API.

Note

For information on the differences between V2 and V3 of the menus API, see Comparing menus API V2 and V3.

Powered by LaunchNotes