Sticky Notes
Sticky notes are freeform note boxes you can drop on the canvas. Use them for design rationale, TODOs, open questions, or any context that doesn't belong on a specific table.
Notes are canvas annotations, not column comments. For inline column or table comments, use the
notefield on the entity itself in the editor panel — see Core Concepts.
Add a note
- Click + Add Note in the toolbar (or canvas menu)
- A new sticky note appears on the canvas
- Click into it to edit the title and body
Each note has:
| Field | Description |
|---|---|
title | Short heading shown at the top of the note |
content | Body text — supports plain text |
color | Background color picker |
position | x, y on the canvas |
size | Width × height (resizable) |
Edit and move
- Click a note to select it
- Drag the header to move it
- Drag the corner to resize
- Edit content directly in the note (or open the editor panel for richer editing)
- Recolor with the color picker — useful for categorizing (e.g., yellow for TODOs, green for done, red for blockers)
When to use a note vs. a column comment
| Situation | Use |
|---|---|
| "This column stores cents, not dollars" | Column note |
| "This whole table is being deprecated next quarter" | Table note |
"We need to discuss whether users.email should be unique" | Sticky note (it's a question, not a fact about the table) |
| "Q1 milestone: refactor billing tables" | Sticky note |
"Avoid joins to legacy_users — it's slated for removal" | Sticky note |
Sticky notes are for transient, conversational, or planning content. Inline notes are for stable facts about the entity.
Visibility
Sticky notes are part of the diagram and persist across sessions. They show up in:
- The canvas (always)
- Public share links (anyone with the link sees them)
- PNG / SVG exports (included in the rendered output)
If you want to hide notes for a clean export, delete them or move them off-screen first. Filters do not hide notes (only tables).
Limits
There's no hard limit on the number of notes per diagram — but very large diagrams with many notes may slow down rendering. If you have hundreds of pieces of context to track, consider externalizing them to your team's wiki or issue tracker.