Skip to content

The Diagram Editor

The diagram editor is where you build a process visually: add steps, connect them, and arrange the layout so the flow is easy to read. This page is a tour of everything you can do on the canvas.

Each shape on the diagram means something specific:

A blue task node on the diagram canvas.

  • Task - a step someone (or something) does. Blue and full-width. A task always leads into a response.

A gray slanted response node on the diagram canvas.

  • Response - the outcome of a task, drawn as a slanted parallelogram so it reads differently from a task at a glance. A task can have multiple responses (Yes / No, Approved / Rejected, and so on), and each one becomes a branch in the flow.

A teal subprocess node with double-bar markers on each side.

  • Subprocess - a link to another process template. Teal, with a black outline and the standard flowchart double-bar markers. Double-click a subprocess to open the linked process.

A yellow sticky note on the diagram canvas.

  • Sticky note - a free-floating annotation. Notes don’t affect the process flow; they just document what’s happening on the canvas.

Every diagram also starts with a Start node, which marks the entry point of the process and can’t be deleted.

Hover over (or click) any node and an amber + button appears at its top-right corner. Click it to add the next node in the flow: a task gets a response, a response gets a task. The new node lines up automatically.

A task node with the amber plus button showing at its top-right corner.

Hover over a node to reveal its connection points: small amber dots on its left and right sides. The left dot is for incoming connections, the right dot for outgoing. Click and drag from a connection point to another node to create a link.

Dragging a new connection from a node's amber connection point toward another node.

Connections that don’t make sense in a process (task to task, response to response, and so on) are rejected with a message explaining why.

Connector lines route at right angles automatically. When a connector loops back to an earlier step, it gets an amber handle in the middle of its horizontal segment. Hover over or select the connector to reveal the handle, then drag it up or down to route the line around other steps.

A loop-back connector with its amber routing handle visible mid-segment.

Moving a node resets the routing handles on its incoming connectors, so lines stay tidy as the layout changes.

  • Zoom with the mouse wheel (or pinch on a trackpad).
  • Pan by clicking and dragging any empty area of the canvas.
  • The diagram automatically fits to your screen the first time it loads.

Right-click an empty area of the canvas and choose Add Sticky Note. Double-click a note to edit its text.

Notes added on a template stay on the template, and notes added on a running process stay on that process. On a template, right-click a note to choose whether it also appears on the diagrams of running processes (Show on Instance Diagrams).

Right-click empty canvas and choose Auto Format Diagram to recompute the whole layout. Only the process flow is rearranged; sticky notes keep their hand-placed positions.

Auto-format only ever runs when you ask for it. The editor never rearranges your diagram on its own; see Your Diagram Keeps Its Shape.

The canvas right-click menu with Add Sticky Note, Auto Format Diagram, and Download Diagram Image.

The same menu is where you can download an image of your diagram.

  • Click a node or connector to select it.
  • Shift+click (or Ctrl+click) to add more items to the selection.
  • Hold Shift and drag across empty canvas to select everything in an area.
  • Ctrl/⌘+C copies the selection and Ctrl/⌘+V pastes it (pasting also works into a different template’s diagram).
  • Delete or Backspace removes the selection. The Start node can’t be deleted.

Ctrl/⌘+Z undoes the last change. Ctrl/⌘+Y (or Ctrl/⌘+Shift+Z) redoes it.

Double-click a node’s text to edit it in place. Enter commits the change, Shift+Enter adds a line break, and Esc cancels.

Changes stay on your screen until you click Save in the toolbar. Nothing is saved automatically, so you can experiment freely and leave without keeping a change. When you do save, the diagram is stored exactly as you arranged it, and every running process shows that same layout. See Your Diagram Keeps Its Shape.