# Show the same diagram on several Confluence pages

To show the same diagram on several Confluence pages, insert **Diagram reference (Capable)** on each extra page and pick the original diagram. The reference draws the diagram from its source, so when someone edits the original, every page that references it shows the change. Nothing is copied, so nothing drifts out of date.

---

## Before you start

| **You need**                                                | **Why**                                                                                                          |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Edit permission on the page where the diagram should appear | You add the reference while editing.                                                                             |
| The diagram already exists                                  | A reference points at a diagram on a page, in a collection or saved as a template. It does not create a new one. |
| Readers who can see the source                              | A reader who cannot view the source page cannot see the diagram, even on a page they can read.                   |

---

## Steps

1. Edit the page where the diagram should also appear and put the cursor where it should go.
2. Type `/diagram reference` and choose **Diagram reference (Capable)**.
3. Next to **Template**, select **Browse**.
4. In **Select a diagram template**, find the diagram under **Diagrams on pages**, **Collections** or **Templates**, select it and select **Insert**.
5. If a **Version** field appears, leave it on **Latest (follows edits)**. Pick a version number only to freeze an older drawing.
6. For a draw.io diagram with several tabs, choose the one to show under **Diagram tab**.
7. Insert the macro and publish the page.

---

## What happens next

Every page with a reference shows the original diagram. Edit the original once and the references follow on their next load.

⚠️

Deleting the page that holds the original breaks every reference to it. Keep shared diagrams on a page that will stay, or save them as templates.

---

## If it does not work

* Some readers see nothing: they cannot view the source page. See [Diagram permissions](https://help.gocapable.com/diagrams/diagram-permissions.html).
* The reference shows an old drawing: a version is pinned. Set **Version** back to **Latest (follows edits)**.
* Every copy of a multi-tab draw.io file shows the first tab: choose the right tab under **Diagram tab** on each reference.

---

## Related

### [Reuse one diagram on many pages](https://help.gocapable.com/diagrams/reuse-one-diagram-on-many-pages.html)

Reuse or copy, and when to use each.

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

Group diagrams so they are easy to pick.

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

For a starting point you intend to change.

### [Copy a link to a Confluence diagram](https://help.gocapable.com/diagrams/copy-a-link-to-a-confluence-diagram.html)

Send someone straight to it.

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

Who can see a referenced diagram.

---

_One diagram, updated once, shown everywhere._