How do I display an existing draw.io diagram in a Confluence page?
Asked by Mark Gregson:

I have a Confluence page with a draw.io 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 draw.io macro, I don't get the popup shown at <https://support.draw.io/display/DFCS/Adding+a+draw.io+Diagram+to+a+Confluence+Page> that would allow me to search for a diagram or select a recent diagram.

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


Answers:
author: David Benson _draw_io_
body: To recover the diagram save the diagram XML locally, then insert a new draw.io 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, <https://ecosystem.atlassian.net/browse/ACJS-107>, that should deal with that.

There's an additional issue affecting saving attachments to draft pages that Atlassian need to resolve <https://ecosystem.atlassian.net/browse/CE-288>. Votes on that would help raise the priority of the issue.

comments: author: Tetyana Novosad
body: Thanks ;)


author: Xxx
body: This drag and drop does not seem to work, is there any other work around to display a saved XML draw.io diagram in the confluence page?


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


author: Muttalip Kocaman
body: create an empty drawio

After that use

File --\> import from --\> Device

and then choose an existing xml file


author: Rik de Valk
body: 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 Draw.io diagram in an Excerpt macro.

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

comments: author: Andrey Kuznetsov
body: It works, thank you!


author: Steven Reilly
body: btw for anyone else looking this totally works


author: simun-strukan
body: The proposed solution doesn't really solve the problem. As Mark pointed out the behaviour described in the offical docs (<https://support.draw.io/display/DFCS/Adding+a+draw.io+Diagram+to+a+Confluence+Page>) 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.  

comments: author: David Benson _draw_io_
body: Are you using Confluence Server or Cloud?


author: Antoine_Raj
body: I just researched and found a way import \& embed the Draw.io 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 Draw.io App listed, then click on "Find new Apps"

5. search for Draw.io 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 draw.io diagram"

11. Upload the saved draw.io 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.

Thanks

Antoine


author: Piers Powlesland
body: 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 draw.io.

Please can you fix this?

comments: author: David Benson _draw_io_
body: 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 :) ). draw.io 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?


author: Patrick Ezell
body: Draw.io 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.


author: David Benson _draw_io_
body: I've added a feature request at <https://trello.com/c/4BoHmyxW/4-allow-viewing-a-diagram-from-another-page>, please vote for it there.


author: Peter Reiser
body: [@David Benson _draw_io_](/t5/user/viewprofilepage/user-id/853291) when will this feature be available for the Confluence Cloud version


author: David Benson _draw_io_
body: Sorry, I missed that message. There is an "Embed draw.io diagram" macro in draw.io for Confluence Cloud that embeds a draw.io diagram stored on another page on the current page being edited.


Tags: cloud

confluence-cloud

draw.io