Important : draw.io diagrams are stored as page attachments. As long as you migrate attachments, the diagrams will appear correctly on pages after migration in any direction (cloud -> server, server -> cloud, server -> server, cloud -> cloud, and server and data center are counted as same thing in this regard). The rest of this article refers to migrating pageID in links within diagrams to the new instance pageIDs, but the basic migration will always work.


draw.io cloud and server apps allow user to export draw.io related data that can improve the quality of the migration between instances (but, as noted, the main migration process still in all directions regardless of whether you follow this process).


The improvements this process makes are to 1) Help the new instance understand embedded macro types are not common between server and cloud instance (not the standard drawio macro, that is understand between instances without the need for translation) and 2) links within diagram to pages. This uses the pageID of the target page, which changes randomly between instances. The page mapping exported corrects the mapping in the links on the target instance.


Server supports both export and import of the pageID mappings, currently, cloud only supports export.


How to export:

- Go to draw.io admin

- Select draw.io export tab

- Click on Export buttonĀ 

- After export is finished download link will appear

- Download file


How to import:

- Go to draw.io admin

- Select draw.io import tab

- Open exported file in text editor

- Copy/paste text from the file to draw.io text box (do not make any changes in it)

- Click submit

- When import is finished link with report will become visible

- Download report and confirm that there are no errors