---
title: Scenario notes
slug: scenario-notes
description: Add notes to modules and routes to document your logic and keep track of important details
image: https://archbee-image-uploads.s3.amazonaws.com/oAyFj2GHlBeBVWF5OAir2/QzA3qifwiyaRNY6M5J8Us_domino-zoomin-purple-a-1.png
docTags: 
createdAt: 2025-05-01T05:45:54.402Z
---

Scenario notes allow you to document and communicate essential details about your scenario with other Make users. Notes serve as an effective way to provide context, instructions, or explanations about different parts of your scenario.

:::hint{type="info"}
Before you start using notes, keep in mind:

- You can attach a note to any module or any route in your scenario. 
- Each module or route can contain up to 200 notes.
- Each note has a 10,000-character limit.
- When you use a lot of formatting, like emojis and links, you might reach the note length limit faster than without formatting.
- Make stores your notes in HTML format, which uses extra characters to set formatting.
- Scenario notes are not included when you [clone](https://help.make.com/clone-a-scenario) or [share a scenario via a link](https://help.make.com/scenario-sharing).
:::

### Create notes

To add a note to a module or route: 

::::WorkflowBlock
:::WorkflowBlockItem
Right-click on the module or route where you want to add a note.
:::

:::WorkflowBlockItem
Select **Add a note **from the context menu. 

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/sirXheD7xX_Fm9AYGFQJn-20260317-125903.png" size="36" width="580" height="680" position="center" darkWidth="580" darkHeight="680" showCaption="false"}
:::

:::WorkflowBlockItem
Enter your content in the text editor.

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/AU7EIlxcVJaLmO4s-MLP6-20260317-130302.png" size="50" width="1146" height="890" position="center" darkWidth="1146" darkHeight="890" showCaption="false"}
:::

:::WorkflowBlockItem
Optional: Use the formatting toolbar to style your text, add links, or insert emojis.
:::

:::WorkflowBlockItem
Click **OK **to save your note. 
:::
::::

This is how notes are displayed in a Scenario Builder when:

1. A note is attached to a module
2. A note is attached to a route

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/isFHVAF4U3FRYAhHcQI-X-20260317-130417.png" size="60" width="1656" height="1184" position="center" darkWidth="1656" darkHeight="1184" showCaption="false"}

### View notes

You have several options to view notes in your scenario:

| What to do                                | What you'll see                                           |
| ----------------------------------------- | --------------------------------------------------------- |
| Hover over the note marker                | A preview of the note                                     |
| Click once on a note marker               | The complete note content with scrolling for longer notes |
| Click the sticky note icon in the toolbar | The note panel showing previews of all scenario notes     |

### Edit notes

To edit a note:

:::::WorkflowBlock
:::WorkflowBlockItem
Click once on a note marker, or hover over it and click the note.
:::

::::WorkflowBlockItem
Click the **three dots **in the top-right corner of the note window, and then **Edit**.

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/gVyqsVwCJJRom0s3uLs0B-20260317-134444.png" size="50" width="872" height="322" position="center" darkWidth="872" darkHeight="322" showCaption="false"}

:::hint{type="info"}
You can also just double-click on a note to open it in edit mode.
:::
::::

:::WorkflowBlockItem
Make your changes in the text editor.
:::

:::WorkflowBlockItem
Click **OK** to save your updates or **Cancel** to discard them. 
:::
:::::

The edits to your note will be saved. 

### Delete notes

To delete a note:

::::WorkflowBlock
:::WorkflowBlockItem
Click once on a note marker, or hover over it and click the note.
:::

:::WorkflowBlockItem
Click the **three dots **in the top-right corner of the note window, and then **Delete**.

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/3L9zk3BUI351ilFu3Z0L0-20260317-133207.png" size="50" width="874" height="338" position="center" darkWidth="874" darkHeight="338" showCaption="false"}
:::

:::WorkflowBlockItem
Click **Delete** once again to confirm.
:::
::::

The note will be deleted. This action is permanent and cannot be undone. 

### Best practices

- Use notes to document complex logic or explain non-obvious workflow decisions.
- Add implementation details that might help other team members understand your approach.
- Document any specific requirements or dependencies for modules
- Explain the purpose of different routes to clarify workflow branching.
- Keep notes concise but informative for better team collaboration.