Introducing Grubtech internal ID for Items, Modifiers, Categories and Modifier Groups

[Release on: 12th March, 2026]

This update introduces a new identifier, gtInternalId, to ensure stable and globally unique identification of menu entities across the Grubtech platform.

In the current menu payload structure, IDs are included for categories, items/modifiers, and modifier groups. These identifiers are unique only within the scope of a menu. As a result, these IDs may change in several scenarios, such as: • When items or modifiers are removed and re-added to the menu • When an item is moved to a different category • When the same modifier groups are attached to multiple items

Because of these changes, relying solely on menu-level IDs can make it difficult to consistently identify entities across menu updates.

To address this limitation, a new field, "gtInternalId", has been introduced.

Key Updates:

New Attribute: gtInternalId

A new attribute, gtInternalId, is now included in the menu payload. • This identifier is globally unique across the Grubtech platform. • It provides a stable reference for identifying menu entities even when menu structures change.

Supported Entities

The gtInternalId attribute will be available for the following menu entities: • Categories • Items • Modifiers • Modifier Groups

Purpose of gtInternalId

The introduction of this identifier enables: • Consistent tracking of menu entities across updates • Reliable mapping of items and modifiers across integrations • Improved stability when menu structures are modified

Backward Compatibility

Existing integrations that rely on current menu IDs will continue to function as expected. The gtInternalId field is introduced as an additional identifier to support more robust entity tracking across the platform.

Note: Existing ID should be used in the order flow