Migrate draw.io between Confluence Instances
You can migrate from your source Confluence with draw.io installed to your target Confluence instance.
The draw.io data in Confluence consists of two parts:
- attachments on the pages that contain the diagram data
- draw.io macros in the pages that use the attachments
Note that no diagram data is stored outside of your Confluence instance, whether that be Server, DC or Cloud.
Both the macros and attachments will port as part of a standard Confluence to Confluence migration.
Important: To ensure links inside diagrams work after migrating, you must perform an additional step. Links in diagrams to Confluence pages contain the page ID of the page. Page names are not used since these break when a page is renamed. Migrating to another Confluence instance will change all of the page ID values, breaking these links.
Use the draw.io Page IDs Export tool
Save where each link in a diagram points to by exporting the Page IDs.
- Go to your Confluence administration, and select draw.io Configuration in the left panel, then select the Page IDs Export tab.
- Select the appropriately target as the Export target, then click Start Export.
- When the export has finished, you’ll see a mapping in the text field below. Select all of this text, copy and paste it into a text editor and save it.
Import the Page IDs into target Confluence
Restore the link targets in your diagrams by importing the page IDs.
- As an administrator, click on the gear icon, then on General configuration.
- Under the draw.io add-on heading, select Configuration, then select the draw.io import tab.
- Copy the contents of that text file, then paste it into the large text field to Import draw.io data from another Confluence instance, then click Start import.