Board notes are how a team discusses a model where it lives. A note sits on the modelling board next to the tables it is about, and holds a thread of comments. Notes are available on every plan.
collab-comments-01-overviewMissing
Board note with a comment thread next to the tables it discusses.
A note has a title (up to 100 characters) and a position on the board. Place it next to the tables or relations it is about. Notes can be collapsed to keep the board readable.
Comments form the thread of a note. A comment has up to 300 characters. You can start a note with its first comment right away.
Live: other people who have the project open see new notes, moves and comments without reloading.
Scope: notes belong to one project. They are not visible from other projects.
collab-comments-03-board-anchoredMissing
Board note placed next to a relation line, with its thread expanded.
People without an account can join a project's board through its collaboration link, which you set up in the project's settings (optionally protected with a password). Guests who write notes or comments count as guest collaborators; how many a project can have depends on your plan — see Account and Plans. On Starter, where you are the only member, guest collaborators are the way to collect feedback from others.
The number of notes per project depends on your plan (see Account and Plans). When the limit is reached, delete notes you no longer need before you add new ones.
When a relation's cardinality is uncertain — is this truly 1:n, or should it be m:n? — put a note right next to the relation line. Anyone inspecting the relation sees the discussion, and the question is not raised twice.
Before finalizing part of the model, ask a reviewer (Reporter role) to look at it and answer in the note's thread. Delete or rename the note once the decision is made, so open notes show open questions.
Comments & Notes
Board notes are how a team discusses a model where it lives. A note sits on the modelling board next to the tables it is about, and holds a thread of comments. Notes are available on every plan.
Board note with a comment thread next to the tables it discusses.
Board Notes
Board note placed next to a relation line, with its thread expanded.
Who Can Do What
Edited comments show that they were edited. Roles are explained in Team & Roles.
Guest Collaborators
People without an account can join a project's board through its collaboration link, which you set up in the project's settings (optionally protected with a password). Guests who write notes or comments count as guest collaborators; how many a project can have depends on your plan — see Account and Plans. On Starter, where you are the only member, guest collaborators are the way to collect feedback from others.
Limits per Plan
The number of notes per project depends on your plan (see Account and Plans). When the limit is reached, delete notes you no longer need before you add new ones.
Effective Workflows
Place Notes Where the Question Is
When a relation's cardinality is uncertain — is this truly 1:n, or should it be m:n? — put a note right next to the relation line. Anyone inspecting the relation sees the discussion, and the question is not raised twice.
Use Notes as Lightweight Review Checkpoints
Before finalizing part of the model, ask a reviewer (Reporter role) to look at it and answer in the note's thread. Delete or rename the note once the decision is made, so open notes show open questions.
Keep Threads Focused
Each note should address a single concern. If a reply introduces a new topic, start a new note next to the element it concerns.
Modelling board with several notes marking open questions.
Common Questions
Can I edit a comment after posting?
Yes, your own comments. Edited comments are marked as edited. You cannot edit or delete other people's comments.
What happens to notes when I delete a table?
Notes are not attached to a table — they have their own position on the board — so they stay where they are. Move or delete them yourself.
What happens to a member's notes when they are removed?
The notes and comments they wrote stay on the board.
Related Pages