Comment on diagrams

Discuss and review a diagram with your team by adding, reading, searching and deleting comments directly in the editor.

Comments let you collaborate on a diagram without changing it. Every comment is attached to a single diagram, shown in the editor sidebar, and tagged with its author and the time it was posted. Comments are a lightweight conversation thread: there are no replies, mentions, attachments or reactions.

Who can comment

Anyone who can open a diagram can comment on it, including users with the Reader role. Because diagrams are scoped to groups, you can only comment on diagrams in groups you belong to. For how roles and groups control access, see Roles and permissions.

Action Who can do it

Add a comment

Any user who can view the diagram (Reader, Creator, Admin)

Read comments

Any user who can view the diagram

Delete your own comment

The author of the comment

Delete any comment

Admin

Open the comments panel

Open a diagram in the editor, then select the Comments tab in the sidebar. The tab shows a count badge with the total number of comments on the diagram. The badge is hidden when there are no comments, and shows 99+ when the count is above 99.

The Comments panel in the editor sidebar

Add a comment

  1. Open the Comments tab.

  2. Type your message in the input box at the bottom of the panel. A counter shows how many of the 500 allowed characters you have used (for example 120/500).

  3. Press Enter to post the comment, or use Shift+Enter to add a line break without sending.

A comment cannot be empty or contain only spaces, and it cannot exceed 500 characters. Your comments appear aligned to one side of the thread, and other people’s comments to the other side, so the conversation is easy to follow.

Comments do not update in real time. Use the reload control at the top of the panel to fetch the latest comments posted by other people while you have the diagram open.

The panel lists comments newest first by default. You can:

  • Sort the thread with the sort control, switching between Newest first and Oldest first.

  • Search the thread with the search control. Searching matches both the comment text and the author’s name, and is case-insensitive.

  • Scroll to load older comments automatically as you reach the end of the list.

Each comment shows the author’s display name, the message, and the date and time it was posted. If the author’s account has since been removed, their name is still shown and marked as deleted so the history stays readable.

Delete a comment

You can delete a comment you wrote: open its options and confirm the deletion. An Admin can delete any comment on a diagram, which is useful for moderating a thread.

Deleting a comment is permanent — there is no undo, and comments cannot be edited after posting. If you need to correct a comment, delete it and post a new one.

When a diagram is deleted, all of its comments are removed with it.