Table groups

Table Groups let you draw labeled regions on the canvas to represent subject areas (e.g., Billing, Auth, Catalog). Use them to visually categorize related tables and to move or manage those tables as a single unit. Think of groups like lightweight “frames” for your schema: they define scope and improve scannability without changing the underlying database objects.

Create a group

There are two ways to add a group to your diagram:

1. Draw a new group region via the toolbar

1. In the editor, choose Add Group from the top toolbar.

2. Click and drag on the canvas to set the group’s bounds. Any
   table within the selection will be added to the group.

3. Give the group a name (e.g., Billing) and optionally choose a color.

2) Create a group from a selection

1. Multi‑select the tables you want to group (use the lasso tool or hold Shift to drag the region).

2. In the left panel, click Create group.

3. Give the group a name and (optionally) choose a color.

Add or remove tables from a group

• Add: Drag a table into the group’s region.

• Remove:

  1. Drag a table outside the group region.

  2. On the group inspector (left panel), click on "Remove from group" from the table in the list.

Reposition group

Select the group header and drag to move the entire subject area. All tables within the group move together, preserving their relative positions.

Resize

Resize the group by dragging its edges or corners. This doesn’t move the tables; it only changes the group boundary.

Note: Resizing a group or dragging a group over existing tables does not automatically add (or remove) those tables. Membership changes only when you drag the table into or out of the group boundary.

Selection and bulk operations

• Single‑click the header to select the group. The inspector (left panel) shows group properties (name, color, children nodes). You can also remove tables

• Group actions

  • Delete - Delete the group but retain children nodes

  • Delete all - Delete the group and all children nodes

  • Duplicate - Duplicate the group and all children nodes

Notes

• Groups are visual only—they tidy the canvas and don’t touch your actual database.

• Each table can belong to one group at a time; no double‑dipping.

• Groups can’t be nested, so keep subject areas flat.

• Dragging or resizing a group over tables won’t auto‑absorb them—if you want a table in a group, drag the table inside the group boundary.