Skip to end of metadata
Go to start of metadata

Switch from LucidChart to in three steps

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 The guide is sequential, so just go through it step by step. 

Note: the Lucidchart to import is not 100% fidelity. These are different software products with different data models, so it never can be 100%. We have invested a lot of time to getting the import as close as possible.

1. Prepare

Migrating from LucidChart to 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

  • LucidChart diagrams with custom shapes or non-standard formatting may not convert to diagrams correctly at first. This is fixable, don’t worry, but migration on a test instance is always best (follow Atlassian's instructions to create a test instance from your production instance).

1.2 Re-index Confluence so all LucidChart diagrams can be found

  • In order to avoid partial or failed conversions, please rebuild the search index (see Atlassian documentation) so the converter can find all LucidChart diagrams later on.

1.3 Check if you have the latest version of

  • If you already have a staging environment and have tested before, please make sure to update to the latest version before you start the migration.

1.4 Do you have full permission to access all LucidChart diagram pages?

  • The administrator that carries out the LucidChart mass import must have write-permission for every Confluence page containing a LucidChart diagram. Otherwise, the mass importer won't be able to save the diagram to that page.
  • If no such user exists, you will need to temporarily promote a user to administrator status in order to have those permissions during the import.

2. Import Test

2.1 Install the app

Firstly, access the general configuration area of your Confluence administration panel and install the 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 add-on. Then, click LucidChart import on the configuration page.

If you've already purchased 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

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 After you updated, 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

3.1 Outside of working hours

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.

3.2 Remove LucidChart license

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.

  • No labels
This page was last edited on 02/18/2021.