Plota docs

6. Layers and pages

Groups and containers#

Select two or more shapes and press Ctrl/⌘ G (or right-click → Arrange ▸ Group). A group container is created around them and they become its children. Ctrl/⌘ ⇧ G ungroups.

Containers are real nodes with a kind of their own — group, plane, lane, fragment, bpmnPool, bpmnLane — so they can be styled, morphed, layered and routed through. Because they are backdrops, connectors are routed through them rather than around them.

On a container the right-click menu adds:

ActionEffect
Fit container to contentsShrinks or grows the frame around its children
Select childrenSelects the subtree
Remove from containerDetaches the selection from its parent
Delete container, keep childrenDeletes the frame and promotes the children
Delete container and contentsDeletes the subtree

Deleting a container with the keyboard asks which of the last two you meant. Dragging a shape over a container highlights it as a drop target and re-parents on release.

Layers#

Left panel → Layers.

Each layer has a name, a visibility flag, a lock flag, a paint-order position and an object count. The row expands to list what is on it.

ActionWhere
Add a layerThe panel, or the palette (Add layer)
Rename / deleteThe row's buttons. Deleting a non-empty layer offers to move its objects to another layer instead
Reorder↑ / ↓ on the row — this is paint order
Hide / lockThe eye and padlock buttons
Move objectsRight-click a selection → Arrange ▸ Move to layer
Un-hide everythingPalette → Show all layers and objects

A locked layer locks everything on it: the canvas refuses the drag and shows a hint. A hidden layer is not exported.

Objects also carry their own hidden and locked flags (Ctrl/⌘ ⇧ H, Ctrl/⌘ L), independent of the layer.

Pages#

One document holds many pages. The page strip sits under the toolbar; the status bar has a compact page selector (, a drop-down, , the count, and × to delete the current page).

ActionHow
AddToolbar Page, or right-click the page strip → Add page
RenameThe Rename button on the strip, or the page context menu
Duplicate / deleteRight-click a page tab
SwitchClick a tab, or use the status-bar selector

Only the active page is live in the editor; the others are held as documents in the file. That matters for export:

  • Plota JSON always writes the whole multi-page document.
  • PDF can write every page into one file (palette → Export every page as one PDF), and the export dialog has a Pages scope selector (Current page / All pages (n)).
  • SVG, PNG, draw.io and Mermaid are per page; exporting with scope All pages writes one file each.