For customers who want to switch from Gliffy to draw.io, the app comes with a practical feature: The Gliffy Mass Import (Confluence Server only). All diagrams created with Gliffy can be quickly and easily imported into native draw.io diagrams.
Follow these three simple steps to mass import all of the Gliffy diagrams in your Confluence instance.
If you are worried about running this directly on your production instance, or if you have custom shapes in your Gliffy diagrams, we recommend you copy your production instance to a test instance, and run a test import there. For more information about this, please see the Gliffy mass import FAQ.
1. Install the draw.io app
In the General configuration under "DRAW.IO ADD-ON" select "Add-on Configuration"
2. Import the Gliffy diagrams
In the Add-on Configuration, select the "Gliffy Import" tab. Click on either the "Start Import" button to import all of the Gliffy diagrams in your instance, or use "Filter by spaces" to import only the diagrams attached to pages in this specific space.
3. Download the report
Wait until the import has finished, and download the report. Use the report to see whether all diagrams were converted successfully, and which diagrams were not able to be imported.
When should you perform the import?
We recommend that you do the conversion outside of the normal usage hours of your Confluence instance. Even though it is possible to perform the conversion while employees are using your Confluence instance, it can significantly delay or extend the conversion process.
We also recommend you do a test import using the Gliffy mass importer on your test instance of Confluence.
What Confluence permissions are needed?
The administrator that triggers the Gliffy mass import must have write permission for every Confluence page containing a Gliffy diagram. Otherwise, the mass importer can't save the draw.io diagram to that page!
Pages with restricted permissions aren´t editable by the administrator and will cause the mass importer to fail to convert the Gliffy diagrams on those restricted pages.
Will draw.io create a backup?
Yes, draw.io automatically creates a backup before the conversion of a diagram begins. You can always revert to a previous version using the version history of the Confluence page.
What happens if you uninstall Gliffy?
You can keep Gliffy in your Confluence instance, even after the support period has ended. Although Gliffy diagrams may not be edited, they will be displayed normally, and can also be converted to draw.io diagrams. If you uninstall Gliffy, draw.io can still perform the mass import, but the Gliffy diagrams will not be visible within your Confluence instance.
Gliffy diagrams with custom shapes or non-standard formatting may not convert to draw.io diagrams correctly.
Space/page permissions can also cause issues during the import process.
Turn on the logging and profiling, generate a ZIP file and contact support. We'll help you resolve your mass import issues as quickly as possible! See the Gliffy mass import FAQ for how to contact support with this information.
1. Enable the logging and profiling
In your Confluence administration, select Logging and Profiling from the left panel.
2. Configure the logging and profiling
Under Add New Entry, enter mxgraph as the Class/Package Name, select DEBUG, then click on Save at the bottom of the page.
3. Create the support ZIP file
Import the diagrams.
In the Confluence administration, under Logging and Profiling, click on Support Tools in the left panel.
Finally, in the Support Tools page, click on the Create Support Zip tab, then click on the Create button.