# Add comments to a diagram in Confluence

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.               |

---

## Related

### [Comments on diagrams](https://help.gocapable.com/diagrams/comments-on-diagrams.html)

Everything about diagram comments.

### [Mention someone in a diagram comment](https://help.gocapable.com/diagrams/mention-someone-in-a-diagram-comment.html)

Get the right person to look.

### [Diagram macro reference](https://help.gocapable.com/diagrams/diagram-macro-reference.html)

The toolbar where the count shows.

### [Diagram permissions](https://help.gocapable.com/diagrams/diagram-permissions.html)

Who can read and write comments.

---

_Say it on the diagram, and the next person will see it._