Frames

Draw titled frames around nodes to organize a graph.

A frame is a titled box drawn around a group of nodes, behind them and their wires. Use frames to label the parts of a large graph, such as "Sky" or "Background", and to move each part as a whole.

Frames only organize the editor: they never change what the graph computes or draws. (To group shapes in the drawing, use the Group node.)

Making a frame

Select the nodes, then press Ctrl+G (⌘G on macOS), or right-click one of them and choose Frame selection. A frame titled "Frame" appears around them, with its title ready to edit: type a title and press Enter.

A frame fits itself around its nodes, with some space around them, and grows or shrinks as they move or change size.

Renaming

Double-click a frame's title, or right-click its title bar and choose Rename (also F2 with only the frame selected). Enter or clicking elsewhere keeps the new title; Escape cancels. An empty title gives "Frame" back.

Colors

Right-click a frame's title bar and choose a color under Color: a neutral default, red, orange, yellow, green, teal, blue, purple or pink. The current one is checked. Colors make the parts of a graph easier to tell apart at a glance, and every color keeps the title easy to read.

Selecting and moving

Click a frame's title bar to select it (Shift+click adds it to the selection). Drag the title bar to move the frame with every node in it.

Only the title bar belongs to the frame: the rest of it lets clicks through, so you can pan, click empty canvas or draw a selection box over a frame as anywhere else.

Adding and removing nodes

  • Drag a node into a frame to add it: drop it with the pointer over the frame. While you drag, the frames stay as they were, so you can see where it will go.
  • Drag a node out and drop it outside every frame to take it out.
  • Right-click nodes and choose Remove from frame to take them out without moving them.

Dragging nodes moves only them: to move a whole frame, drag its title bar. A frame left without nodes goes away.

Frames inside frames

Frames can hold other frames, for sections inside sections:

  • Select frames (click their title bars, Shift+click for more, with nodes too if you like) and press Ctrl+G to put them in a new frame around them. Frame selection in a frame's context menu does the same.
  • Drag a frame by its title bar onto another to put it inside; drop it outside every frame to take it out. Remove from frame in a frame's context menu takes it out without moving it. A frame can't go inside itself or one of the frames inside it.

A frame fits around the frames inside it and is drawn behind them. Dragging it moves everything inside, and deleting it keeps the frames and nodes inside it, one level up.

Collapsing

Click the arrow at the left of a frame's title bar, or choose Collapse frame in its context menu, to fold the frame to its title bar: the nodes and frames inside it are hidden, which saves space while you work on the rest of the graph. Click the arrow again, or choose Expand frame, to show them.

  • Wires between the hidden nodes and the rest of the graph stay visible: each ends on its own small stub on the title bar, inputs on the left and outputs on the right. Wires between the hidden nodes are hidden too.
  • Collapsing a frame changes nothing in the drawing.
  • Collapsing a frame hides the frames inside it; expanding it shows them as they were, collapsed or not.
  • Hidden nodes can't be selected, so Select all, a selection box or Delete never touch them. To change them, expand the frame first. Nothing can be dropped into a collapsed frame either.
  • Whether a frame is collapsed is saved with the drawing, and collapsing and expanding can be undone.

Deleting

Select a frame and press Delete, or right-click its title bar and choose Delete frame. Its nodes stay where they are.

Saved with the drawing

Frames are saved in the drawing's file, each graph with its own: frames work inside subgraphs too. Every frame action is one undo step, such as "Frame selection", "Frame color" or "Move frame".

Duplicating, copying and pasting nodes, or moving them into a new subgraph, doesn't copy their frames: the new nodes are outside any frame.

See also

© 2026 Wirepaint