Skip to main content

Sticky notes

Sticky notes allow you to annotate flows with documentation, comments, and organizational information directly on the flow canvas. Notes help document workflow logic, add TODOs, or explain complex sections to team members.


There are two types of sticky notes:

  • Free notes: Can be placed anywhere on the canvas for general comments or documentation
  • Group notes: Attached to a selection of nodes to document specific workflow sections

Creating sticky notes​

Free notes​

Create free notes to add general documentation or comments anywhere on the flow canvas.

Method 1: Toolbar button

  1. Click the sticky note button in the top toolbar
  2. Drag and drop on the canvas to position the note

Method 2: Context menu

  1. Right-click anywhere on the canvas
  2. Select "Add sticky note" from the context menu

Sticky notes interface

Group notes​

Group notes attach to multiple selected nodes to document specific workflow sections or logical blocks.

Creating group notes:

  1. Enter selection mode by clicking the cursor/hand button in the top-right of the flow pane
  2. Select multiple nodes by clicking and dragging or clicking individual nodes while holding Shift
  3. Click "Create group note" button that appears when nodes are selected

Selection mode tips:

  • In selection mode: Hold Ctrl/Cmd to temporarily pan the canvas
  • In pan mode: Hold Ctrl/Cmd to temporarily select nodes

Group note example

Managing sticky notes​

Editing content​

Double-click any note to edit its content. Notes support GitHub-flavored Markdown (GHMd) for formatting.

Customizing appearance​

Each note has an action bar in the top-right corner with the following options:

  • Color picker: Change note color (supports both light and dark themes)
  • Lock icon: Lock the note to prevent accidental editing or movement
  • Delete button: Remove the note from the flow

Sticky note action bar

Positioning notes​

Drag notes freely around the canvas to position them where most relevant. Locked notes cannot be moved until unlocked.

Hiding and showing notes​

Use the toggle button in the top-left of the flow pane to hide or show all sticky notes. This is useful when you need a clean view of the flow logic or when presenting to stakeholders.

Free note example​

Free notes are ideal for:

  • General flow documentation
  • TODO items for future improvements
  • Warnings or important considerations
  • Links to related resources or documentation

Free note example

Working with group notes​

Group notes automatically maintain their association with the selected nodes. However, there are some limitations when editing the grouped nodes:

To modify nodes in a group note:

  • Option 1: Delete the note, make your node changes, then create a new group note with the updated selection
  • Option 2: Edit the flow directly in YAML/JSON format to modify the grouped nodes while preserving the note

Group notes are particularly useful for:

  • Documenting complex logic blocks
  • Explaining error handling sections
  • Describing data transformation steps
  • Marking deprecated or experimental features
Flow editor components
Details on the flow editor's major components including toolbar and canvas features.
Testing flows
Iterate quickly and get control on your flow testing.