It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

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

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

Xxx I'm New Here Jun 13, 2019

This drag and drop does not seem to work, is there any other work around to display a saved XML diagram in the confluence page?

File->Import? If that doesn't work, open the file in a text editor, what does the first 50 or so lines look like?

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 # people like this

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

Introducing Confluence Cloud and Jira Software Cloud Premium

Wherever you are in your team’s journey , our goal is to support your big ambitions. We’re a cloud-first company with the mission of unleashing the potential of every team, and to address the range ...

694 views 5 18
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you