Table Groups

Table groups let you visually organize related tables on the canvas. A group draws a colored bounding box around its member tables, making large diagrams easier to navigate and understand at a glance.

---

Creating a group

Open the Tables tab in the left sidebar. At the top of the panel you'll find the Create Group button.

1. Click Create Group
2. A new empty group appears in the sidebar with a default name
3. Rename it to something meaningful (e.g. Auth, Billing, Analytics)

You can also create a group from the canvas context menu after selecting multiple tables.

---

Adding tables to a group

Drag tables from the sidebar table list into a group to add them as members.

• Each table can belong to one group at a time
• Adding a table that already belongs to another group moves it to the new group
• The canvas updates immediately — the bounding box expands to include the new member

You can also add tables from the group's edit panel on the right side when the group is selected.

---

Group colors

Every group has a configurable color that controls the bounding box fill and border on the canvas.

To change a group's color:

1. Select the group on the canvas or in the sidebar
2. In the edit panel on the right, click the color swatch
3. Pick a new color from the palette

The color appears both on the canvas bounding box and next to the group name in the sidebar, so you can quickly identify which group is which.

---

Canvas bounding box

On the canvas, each group is rendered as a labeled rectangle that surrounds all of its member tables.

• The group name is displayed at the top of the bounding box
• The box automatically resizes as you move tables in or out
• Dragging the group header moves all member tables together
• The bounding box uses a semi-transparent fill so table contents remain readable

---

Deleting a group

Select a group on the canvas and press Delete or Backspace.

• The group is removed immediately — there is no confirmation modal
• Member tables are not deleted — they remain on the canvas as ungrouped tables
• The deletion is fully undoable with Ctrl+Z

You can also delete a group from the sidebar by right-clicking it and choosing Delete.

---

Editing a group

Click a group on the canvas or in the sidebar to open the edit panel. From there you can:

Action	How
Rename	Edit the name field at the top of the panel
Change color	Click the color swatch and pick a new color
Remove a member	Click the remove icon next to a table in the member list
Add members	Drag tables into the group from the sidebar

---

Tips

• Groups are a visual-only concept — they don't change the schema or affect foreign keys
• Use groups to mirror your domain boundaries (e.g. one group per microservice or bounded context)
• Combine groups with Filters to show or hide entire sections of your diagram
• Group creation and deletion are tracked by Undo / Redo, so feel free to experiment