Row

A Row represents a horizontal block inside a menu layout, containing one or more cells arranged side-by-side. Rows are used to structure and organize interactive elements (cells) within a menu. Each row belongs to a specific menu, and the order of rows determines their vertical stacking.

A row must contain at least one cell.

Rows are rendered sequentially based on their row_order.

Used for building flexible layouts like forms, lists, or action groups within a menu.

Field	Type	Required	Access	Description
`row_id`	String	Yes	🟢 Writable	Unique identifier for the row. Used to reference and manage the row independently.
`row_order`	Number	Yes	🟢 Writable	Defines the vertical order of the row within the menu.
`menu_id`	String	Yes	🟢 Writable	Identifier of the parent menu this row belongs to.
`row_version`	String	Optional	🔵 Read-only	Auto-generated version of the row. Updates when any cell inside the row changes.
`cells`	Array of Cells	Yes	🟢 Writable	The cells in this row, laid out side by side. At least one is required.

Example

json
{
  "row_id": "r_bMCvsAZ5ZVkMx2C",
  "row_order": 0,
  "menu_id": "PBw7HmDu5FAWjFm",
  "row_version": "FoLSTFJYg48eXrDp",
  "cells": [
    {
      "cell_id": "b_BKwMwhIVbBFw634",
      "form": "button",
      "style": "filled",
      "cell_order": 0,
      "callback": "b_BKwMwhIVbBFw634",
      "label": "Save"
    },
    {
      "cell_id": "b_b2ZRG1YmHStEPo5",
      "form": "button",
      "style": "tonal",
      "cell_order": 1,
      "callback": "b_b2ZRG1YmHStEPo5",
      "label": "Delete"
    }
  ]
}