# Annotations

Annotations let you add **documentation notes** to any node or edge in your
workflow. They help explain the purpose of components and make workflows easier
to understand for other team members.

## Adding an annotation

1. Select a node or edge by clicking on it.
2. In the Property Panel on the right, find the **Annotation** field.
3. Type your note.

The annotation is saved as part of the model data.

## Viewing annotations on the canvas

Annotations appear as labels attached to their nodes or edges on the canvas.

### Toggle visibility

Click the **annotation toggle** button in the toolbar to show or hide all
annotations globally:

- **Icon outline**: Annotations are hidden.
- **Filled/inverted icon**: Annotations are visible.

![Canvas with annotations visible on nodes and edges](../assets/screenshots/annotations.png){ .screenshot }

Hiding annotations keeps the canvas clean when you want to focus on the
workflow structure rather than documentation.

## Tips

- Use annotations to document *why* a component exists, not just *what* it
  does.
- Annotations on edges are especially useful for explaining condition logic.
- Toggle annotations off when you want an uncluttered view of the workflow
  structure.
