There are a number of ways to reuse your draw.io diagrams in Confluence Cloud:

  1. Embed (reuse) a diagram - this means you have one diagram in a number of locations, and when you update the original diagram (the master), wherever you have embedded it will update automatically.
  2. Copy a diagram - this creates a new diagram file on another page, with a new version history.
  3. Move a diagram - simply copy the diagram onto the new page, then delete the original.


1) How to embed a draw.io diagram on another page


This is when you want to display a diagram on another page. Embed diagrams when you want the copy on that page to be updated when the original is edited.


Embedding a diagram works similarly to the "Excerpt" and "Excerpt Include" Confluence macros - there is one master diagram (single source) that is simply displayed (embedded) in other locations using the diagram viewer. You can embed diagrams from one space in pages in another space.


1. Edit the page you want to display the diagram on and start typing "/draw". Select the Embed draw.io diagram macro from the suggestions.


2. Choose the diagram you wish to embed - recently updated diagrams are shown by default.  Select the diagram you want to embed, then click Select

  • If you don’t see your diagram here, click on the Search tab at the top, and search for the name of your diagram. All diagrams with that name will appear in the results. Click on the one you want, then click Select
  • You can hover over any diagram preview to see its file name. 



3. You'll see a preview of the diagram so you can check it is the one you want to embed. Click Insert to embed it in your Confluence page.


You won't be able to edit the diagram from the Confluence page when you have used the "Embed draw.io diagram" macro. You'll need to find the page that has the original diagram and edit it there. 




2) How to make a copy of an existing draw.io diagram


This is when you want to duplicate the diagram file and then edit the copy without changing the original diagram. 


You can also copy pages from one space to another space using the steps below.


1. Edit the page you want to display the diagram on and start typing "/draw". Select the draw.io Diagram macro from the suggestions.



2. Choose the diagram you wish to make a copy of - click on the Recent tab to see the most recently updated diagrams.  Select the diagram you want to copy, edit the Diagram Name, then click Create.

If you don’t see your diagram here, enter the file name of your diagram in the Search field and then click on Search.  

Select the diagram you want to copy, then click Create.


Note: You can hover over any diagram preview to see its file name.


Copying a diagram adds a new diagram file to the list of draw.io Diagrams in your Confluence Cloud space.


There are several other ways to create a copy of a draw.io diagram: 

  • Export your diagram as an XML file and import it into a draw.io diagram at its new location.
  • Select everything in the original diagram, copy and paste it into a new draw.io diagram at the new location (not so good for multi-page diagrams).
  • Select everything and drag it into the scratchpad in draw.io. Create a new diagram on your target page and paste the diagram in from the scratchpad (not so good for multi-page diagrams).



3) How to move a draw.io diagram from one page to another


To move a diagram from one page to another, you first need to copy the diagram (create a new diagram file in your instance), and then delete the original page/diagram. 

Note: The new copy (the moved diagram) will not retain its revision history.


  1. Make a copy of your draw.io diagram - follow the steps at (2) above. 
  2. Once you have made a copy of the diagram on a different page and published it, you can delete the draw.io macro from the source page and save it. This only deletes the diagram from the page - it will still exist as a draw.io diagram in your instance. 


Recommended: Don't delete draw.io diagram files

Note that the draw.io diagram file will still exist as an attachment to that original page and in the draw.io diagrams list of files in your instance. We recommend to leave those in place. If you revert the page to an earlier version after deleting the draw.io diagram file, the draw.io macro on that page will show an error because the attachment is missing.