Add comments to a diagram in Confluence

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

To add a comment to a Capable diagram in Confluence, open the diagram full screen with Maximize, select the Comments button next to the download and share buttons, type your comment and select Comment. Comments are real Confluence comments, so anyone you @mention is notified as usual.

#Before you start

  • You need to be able to edit the diagram, which normally means edit permission on the page it is on. Anyone who can view it can read comments.

  • The diagram must be saved. Built-in examples and unsaved drafts have no Comments button.

#Steps

  1. Open the page and hover over the diagram.

  2. Select Maximize. If the diagram already has comments, you can select the yellow comment count instead, which opens straight onto them.

  3. Select Comments. The comments sidebar opens on the right.

  4. Type your comment in the box that says Comment on this diagram…. Type @ to mention someone or / to link a page.

  5. Select Comment, or press Cmd+Enter on a Mac or Ctrl+Enter on Windows.

#What happens next

  • Your comment appears at the bottom of the list, and the Comments button turns yellow with the count.

  • Back on the page, the count shows as the first button in the diagram's toolbar once you close the full-screen view.

  • People you mentioned get a Confluence notification.

  • To change your comment later, select Edit comment on it, make the change and select Save.

#If it does not work

Message

What happened

Only people who can edit this diagram can comment.

You can read but not write. Ask a page owner for edit permission.

Comments on this diagram are not available to you.

Confluence says you cannot view the diagram's comments, usually because of page restrictions.

No Comments button

You are looking at a built-in example or a diagram that has not been saved yet.

Say it on the diagram, and the next person will see it.