How do I display an existing diagram in a Confluence page?

I have a Confluence page with a diagram attached. I can see the diagram XML and a PNG in the attachments list for the page but the diagram is not shown on the page.

If I insert a new macro, I don't get the popup shown at that would allow me to search for a diagram or select a recent diagram.

How do I insert a macro that references this existing diagram?

4 answers

1 accepted

5 votes
Answer accepted

To recover the diagram save the diagram XML locally, then insert a new diagram into that Confluence page. When the diagram editor is open drag and drop that saved XML into the editor and the diagram will load. Then save the new diagram to the page.

The current mechanism does seem to occassionally save the diagram to a child page, instead of the current parent. Atlassian are releasing a fix to this on Monday,, that should deal with that.

There's an additional issue affecting saving attachments to draft pages that Atlassian need to resolve Votes on that would help raise the priority of the issue.

Hi, I have personally used the Excerpt and Excerpt include Macros to achieve this. It's not a direct solution; more a work-around. But it works for me! 

I simply enclose the diagram in an Excerpt macro. 

After that I can include the diagram in any other page by using the Excerpt include macro. 

It works, thank you!

btw for anyone else looking this totally works

The proposed solution doesn't really solve the problem. As Mark pointed out the behaviour described in the offical docs ( doesn't occur in confluence when trying to add an existing diagram to a page. You should consider editing the docs, with some troubleshooting, or fix the bug in drawio plugin.
Secondly the propsed solution doesn't provide the desired workflow. If I want to use the same graph on multiple pages, I wan't to have 1 graph loaded. If I have 6 images with the same grpah I would need to copy the XML (as proposed) 6 times, and have 6 identical files saved in the cloud.
Main problem imho is that the offical docs are describing a feature withc either doesn't exist, or it has bugs. You should fix this either way.


Are you using Confluence Server or Cloud?

As it stands the plugin is totally useless, I cannot share a single diagram between multiple pages so I am reduced to inserting a link to the diagram in question, which i can do with plain


Please can you fix this?

I don't agree it's a bug, but I can see it would be useful (not sure the plugin is "totally" useless in its current state either :) ). is a static plugin in cloud, I don't think a search is possible in the splash. What about if we allowed you to paste a URL of an attachment to implement this? isn't useless w/o this feature - but it would be extremely useful if I could embed the same Diagram on multiple confluence pages - maintaining one source of truth for whatever the purpose the diagram is intended for.

If a search isn't possible (ideal case), then pasting a URL would be very helpful and provides the single source of truth for a diagram used on many Confluence pages.

@David Benson [] when will this feature be available for the Confluence Cloud version 

Like 1 person likes this

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,398 views 2 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you