These docs are for v1.0. Click to read the latest docs for v1.2.

Groups are collections of items, such as shapes, lines, or other groups. Groups cannot contain layers. Groups allow you to combine multiple items into a single, manageable unit. When you group items, you can move, resize, or format them collectively, treating the group as a single object. This is particularly useful when you want to maintain the relative positions of multiple items or when you want to apply formatting or actions to a set of items simultaneously.

Group Format

PropertyDescription
idID
Identifier for a given group (must be unique).
Required
itemsArray[ID]
An array of IDs of all Shapes, Lines, and Groups in the group.
Optional
noteText
Text to add as a note to the group.
Optional
customDataArray[Custom Data]
An array of custom data in the group. See Custom Data for a description of its purpose.
Optional
linkedDataArray[Linked Data]
An array of linked data in the group. See Linked Data for a description of its purpose.
Optional
{
  "id": "group1",
  "items": [ ... ],
  "note": "Test Note",
  "customData": [ ... ],
  "linkedData": [ ... ]
}