Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

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?

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

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?

create an empty drawio

After that use

File --> import  from --> Device

and then choose an existing xml file

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

Like mik009 likes this

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?

I just researched and found a way import & embed the diagrams in Confluence.

Below are the steps I followed

1. click on 'Switch to' and select "Administration"

2. scroll down to Application settings & click on 'Confluence'

3. A new page opens up , then scroll down to 'Manage Apps'

4. If don't find App listed, then click on "Find new Apps"

5. search for and install the plugin

6. close the page once installed

7.  click on 'Switch to' and select "Confluence" mode

8. Navigate to the existing confluence page in edit mode.

9. click on "+" symbol and scroll down and select 'View more'

10. click "Visuals & images" - > now select "Embed diagram"

11. Upload the saved diagram and click on 'Select' and "Insert'


Now the entire diagram is embedded in the confluence page and can be edited on the page itself.


Let me know your feedback, if it works out.




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 _draw_io_ when will this feature be available for the Confluence Cloud version 

Like # people like this

Sorry, I missed that message. There is an "Embed diagram" macro in for Confluence Cloud that embeds a diagram stored on another page on the current page being edited.

Suggest an answer

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

What do you think is the most *delightful* Confluence feature? Comment for a prize!

- Create your own custom emoji 🔥 - "Shake for Feedback" on mobile 📱 - An endless supply of GIFs via GIPHY 🤩 Is there anything quite as nice as a pleasant surprise? Comment below with what...

462 views 24 9
Join discussion

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