Add notes and documentation

Sticky notes let you annotate and comment on your workflows.

n8n recommends using sticky notes on template workflows to help other users understand your workflow.

A basic workflow with a sticky note attached

Create a sticky note

Sticky notes are a core node. To add a new sticky note:

1. Open the nodes panel.

2. Search for note.

3. Click the Sticky Note node. n8n adds a new sticky note to the canvas.

Edit a sticky note

1. Double-click the sticky note you want to edit.

2. Write your note. This guide explains how to format your text with Markdown. n8n uses markdown-it, which implements the CommonMark specification.

3. Click away from the note, or press Esc, to stop editing.

Change the color

To change the sticky note color:

1. Hover over the sticky note.

2. Select Change color .

3. Choose from seven preset colors, or click the rainbow gradient button to select a custom color.

Color selector showing preset colors and custom color button

Custom colors

Besides the seven preset colors, you can select any custom color for your sticky notes:

1. Click the button with the rainbow gradient and plus icon.

2. Use the color picker to select your desired color, or enter a hex color code (for example, #FF5733).

3. Click Apply to set the color.

n8n automatically saves your last-used custom colors (up to eight) and displays them in the color picker for quick access.

Custom colors feature theme-aware borders that automatically adjust for optimal visibility in both light and dark modes.

Sticky note positioning

You can:

• Drag a sticky note anywhere on the canvas.

• Drag sticky notes behind nodes. You can use this to visually group nodes.

• Resize sticky notes by hovering over the edge of the note and dragging to resize.

• Change the color: select the Options menu to open the color selector.

Writing in Markdown

Sticky Notes support Markdown formatting. This section describes some common options.

The text in double asterisks will be **bold**

The text in single asterisks will be *italic*

Use # to indicate headings:
# This is a top-level heading <a href="#this-is-a-top-level-heading" id="this-is-a-top-level-heading"></a>
## This is a sub-heading <a href="#this-is-a-sub-heading" id="this-is-a-sub-heading"></a>
### This is a smaller sub-heading <a href="#this-is-a-smaller-sub-heading" id="this-is-a-smaller-sub-heading"></a>

You can add links:
[Example](https://example.com/)

Create lists with asterisks:

* Item one
* Item two

Or created ordered lists with numbers:

1. Item one
2. Item two

For a more detailed guide, refer to CommonMark's help. n8n uses markdown-it, which implements the CommonMark specification.

Make images full width

You can force images to be 100% width of the sticky note by appending #full-width to the filename:

![Source example](https://<IMAGE-URL>/<IMAGE-NAME>.png#full-width)

Embed a YouTube video

To display a YouTube video in a note, use the @[youtube](<video-id>) directive with the video's ID. For this to work, the video's creator must allow embedding.

For example:

@[youtube](ZCuL2e4zC_4)

To embed your own video, copy the above syntax, replacing ZCuL2e4zC_4 with your video ID. The YouTube video ID is the string that follows v= in the YouTube URL.

See Workflow components for other elements you can add to a workflow.

Related resources

• Workflow components

• Work with nodes

• Connect nodes together

• Canvas Groups

• Find your workflow ID