This page will guide you through your LucidChart migration. We start with a few basic settings and recommendations before we actually perform the switch to draw.io. The guide is sequential, so just go through it step by step.
Migrating from LucidChart to draw.io is fairly easy; you can switch with one mouse click. However, we do recommend that you take care of a few things in advance in order to save time and so the converter can run smoothly.
1.1 We highly recommend that you perform the mass import on a test instance first
1.2 Re-index Confluence so all LucidChart diagrams can be found
1.3 Check if you have the latest version of draw.io
1.4 Do you have full permission to access all LucidChart diagram pages?
2.1 Install the draw.io app
Firstly, access the general configuration area of your Confluence administration panel and install the draw.io app in the Atlassian Marketplace section. After installation, apply the 30-day trial license and select Configuration, which you will find under in the navigation panel under draw.io add-on. Then, click LucidChart import on the draw.io configuration page.
If you've already purchased draw.io for Confluence Server, use your license key together with your Confluence developer license.
2.2 Import the LucidChart diagrams
Click on the Start Import button to import all of the LucidChart diagrams in your instance. The duration of the import depends on the number and the complexity of the existing diagrams, and doesn't normally take longer than a few minutes. With just one click, all of your LucidChart diagrams within a Confluence instance can be imported into draw.io.
Important! During the import your browser needs to be open all the time and your computer will not switch to sleep mode!
2.3 Copy/paste the report
Wait until the import has finished, and have a look at the web report. Use the report to see whether all diagrams were converted successfully, and which diagrams were unable to be imported.
Things didn't go as planned? No problem, we just need to adjust the script. Just copy the web report and contact us - we will take care of everything else.
Run the LucidChart importer again for individual diagrams
If there are only a few LucidChart diagrams that haven’t been converted the way they should, you can take a shortcut to run the mass importer again. Of course this only applies if we enhanced the mass importer after you contacted us and issued a new version of draw.io. After you updated draw.io, just open the Confluence pages that contain the specific LucidChart diagrams and restore the page version that contained the Lucidchart macro on the Confluence page. Once you did that, you can re-run the migration script.
3. Live Migration
If the report didn’t show any issues with complex LucidChart diagrams you can perform the conversion on your live instance (since version 9.4.6, you can either convert all diagrams at once or choose specific Confluence spaces to only convert the diagrams within this specific space). We recommend that you perform the conversion outside of your company's normal Confluence usage hours. It is possible during normal working hours, but it's best to carry out the whole operation whilst the minimum number of changes are being made to the relevant pages.
The recommendation of removing the LucidChart license is so that users do not start editing LucidChart diagrams while the process is running, effectively making LucidChart diagrams read-only. It is worthwhile communicating with users that you are carrying out the migration, and when you expect to start the process.