Using Lucidchart for Confluence Server

This article will teach you how to use Lucidchart for Confluence Server.

The Lucidchart app for Confluence is only available for Team and Enterprise accounts. If you are an admin of a Lucidchart Team or Enterprise account, you can install the Lucidchart App to your Confluence Cloud or Server instance.

If you do not have a Lucidchart account, a free team trial is available on the pricing page. If you have already completed a trial and currently have a Free or Individual account, go to the Subscription Level page within your account and select the appropriate team license tier.

To add a Lucidchart diagram to a Confluence page, follow these steps:
  1. Create a Confluence page or open an existing one and click "edit"

  2. Click "+" (insert more content) from the bar at the top and select "Add Lucidchart Diagram." If you do not see this option, contact the admin of your Lucidchart account.

  3. If you are logged in to Lucidchart, your Lucidchart documents page will load. If you are not logged in, enter your Lucidchart credentials.

  4. Hover over the document that you would like to add and click "Select." You can also create a new document or import a Visio, Gliffy,, or OmniGraffle file. Once selected, the document will load onto your Confluence page.

  5. Click "Update" to publish the document to the Confluence page.


    Once published, everyone who has permissions for that page will be able to view the document.
If you have edit access to a Confluence page with inserted diagrams, you can edit those diagrams in Lucidchart and push those changes to Confluence.

To edit a diagram that has already been added to a Confluence page, follow these steps:
  1. Click "Edit" at the top of the Confluence page and then click "Edit" from the options bar that appears on the inserted diagram.



    Alternatively, on the published page, hover over the diagram and click the "Open with Lucidchart" button.


    The document will open in the Lucidchart editor.
  2. Make changes to the Lucidchart document. When you are done, click "Back to Confluence" in the top left corner of the Lucidchart editor.


    The changes will automatically be synced to the diagram in Confluence.
  3. Click "Update" at the bottom right of the Confluence page to publish your changes.

To delete a diagram that has already been added to a Confluence page, follow these steps:
  1. Click "edit" at the top of the Confluence page.

  2. Click on the inserted diagram and click "Remove" from the options bar that appears.

  3. Click "Update" at the bottom right of the Confluence page to publish your changes.

Sharing permissions for documents will be inherited from the Confluence page. This means that if you can view and edit a Confluence page and are a licensed Lucidchart user, you will be able to view and edit the documents on that Confluence page.
To change the display properties of an inserted diagrams, click "Edit" at the top right of the Confluence page, then select the diagram and click "Properties" from the bar that appears.


A modal titled Diagram Properties will open.


In this modal, you can adjust the following settings:
  • Adjust the width and height of the inserted diagram.
  • Turn autosize on or off.
  • Adjust the alignment of the diagrams display on the Confluence page.
  • Dictate which pages of the Lucidchart document are available to viewers of the Confluence page (eg. 3 or 2-3). 
    • Note: A page's number is determined by it's position (i.e. when viewing a diagram in Lucidchart, the page tab third in line is page 3). Additionally, selecting a page or page range is only possible if you are using the rich viewer. 
  • Switch between the Rich and Simple viewers (see below for more info)
  • Enable auto-update (see below for more info). Note: enabling auto-update is only possible if you are using the rich viewer.
When you are done making changes to these settings, click "Save."
The Lucidchart app for Confluence allows you to automatically push changes from the Lucidchart editor to the diagrams displayed in Confluence. To enable auto-update for a specific diagram, follow these steps:
    1. Select the diagram.
    2. Click "Properties" from the options bar at the bottom.
    3. Click "On" underneath the option to "Automatically update this diagram with changes made in Lucidchart."
    4. Click "Save."
Note: It is only possible to enable auto-update on an individual diagram basis.
There are two viewers available for displaying Lucidchart diagrams in Confluence Server: Simple and Rich. The Simple viewer is hosted on Confluence servers and provides a static PNG of the diagram. The Simple viewer is available in Chrome, Firefox, Safari, and Internet Explorer.

To display a diagram with the Simple viewer, select Off beneath "Use Rich in Lucidchart viewer" in the Diagram Properties modal.



When hovering over the diagram, a series of icons will appear in the corner of diagrams displayed with the Simple viewer, allowing viewers to do the following actions:
  • Edit the diagram in Lucidchart
  • Remove the diagram from the Confluence page
  • Switch to the Rich viewer
  • Refresh to the latest version of the Lucidchart diagram
  • Zoom in and out of the diagram
  • Note: It is not possible to dictate which pages of the Lucidchart document are available to viewers when using the Simple viewer. You will need to use the Rich viewer to access this functionality. 
If the inserted diagram contains multiple pages, you can toggle between them by clicking on the corresponding arrow that appears on the side of the viewer when you hover over the displayed diagram.
There are two viewers available for displaying Lucidchart diagrams in Confluence Server: Simple and Rich. The Rich viewer is hosted on Lucidchart servers and required internet access to run. It provides full interactivity with Lucidchart. The Rich viewer is available in Chrome, Firefox, and Safari, but is not available in Internet Explorer.
To display a diagram with the Rich viewer, select "On" beneath "Use Rich in Lucidchart viewer" in the Diagram Properties modal.



A frame will appear when hovering over diagrams displayed with the Rich viewer, allowing viewers to do the following actions:

Top of frame:
  • Open Lucidchart in a new browser tab
  • View diagram title
  • Present any slides that have been created in the diagram
  • Enter full-screen mode
  • Open up the Viewer Options modal, containing the following options:
    • Show notes
    • Show hotspots
    • Enable WebGL
    • Update to the latest version of the diagram

Bottom of frame:

  • Select different page tabs to view
  • View different layers in the diagram
  • Zoom in and out of the diagram
Login Loop
If, when trying to use the integration, you experience a login loop where you are continuously prompted to sign into Lucidchart, it is most likely due to 3rd party cookies being blocked for your browser. Please reference this article for details on how to change that setting so they are no longer blocked. 
You are not on a team associated with this instance
If you receive the error: "You are not on a team associated with this instance."  In all likelihood your specific user is connected to the incorrect Lucidchart team.  To fix this, follow these steps:
    1. Log in to your Lucidchart account that is currently incorrectly linked to Confluence. If you do not know what email is linked stop here and let us know. We will be able to find the incorrect link and sever the connection.
    2. Go to the External Applications page under account settings.
    3. Check the box next to 'Confluence' and then click the 'Remove' button. This will disconnect the account.
    4. To re-establish the correct connection, logout of Lucidchart. You will then need to insert any diagram into a Confluence page. When prompted to log into Lucidchart, make sure you are logging in with the email associated with your organization's Lucidchart account (not the email you logged in with in step 1) that is linked to the Confluence account you are attempting to link to.
If you see the following OAuth timestamp error when you try to install/configure the Lucidchart Confluence Server connector,

org.scribe.exceptions.OAuthException: Response body is incorrect. Can't extract token and secret from this: 'oauth_problem=expired_timestamp,_yours_1359614629,_ours_1359585813'

This likely means that the timestamp on your server hosting Confluence is not particularly accurate. Even if your server time seems okay, a discrepancy of 15-30 seconds can result in two servers not wanting to talk to each other. It's not possible to manually adjust server time with enough precision, so you'll need to synchronize your timestamp with an NTP server.

To convert your diagrams to Lucidchart diagrams in Confluence Server, follow these steps:
  1. Navigate to the page that contains the diagrams you would like to convert.
  2. Open the file in and download as a XML file.
  3. Go into edit mode in your Confluence page.
  4. Using the plus icon on the toolbar at the top of the editor, insert a new Lucidchart diagram via the Lucidchart selection in the dropdown.
  5. Once the Lucidchart editor opens you can import the diagram via the import menu.
  6. Once the diagram imports, select it from the documents list and it will be added to your Confluence page. At this point you will be redirected back to Confluence.
  7. The conversion is now finished and you can delete your original diagram from your Confluence page.
Please Note: The experience in Confluence Server and Confluence Cloud is different. If you are using Confluence Cloud please navigate to this article.
If you are inserting a diagram in Confluence and feel as though there is an abnormal amount of white space that isn’t related to the below functionality please reach out to Lucidchart Support by emailing and provide the following info so we can take a closer look: a screenshot of what the diagram looks like on the Confluence page and the URL to that diagram from within Lucidchart.
Uneven White Space (Shifted Diagram)
If you created your diagram using a template there is likely a shape to the side of the canvas that has details about the template. This shape can sometimes cause the diagram to be shifted if you insert it in Confluence. If you delete the shape the issue will be resolved.
Even White Space (Margins)
Depending on the shape of your diagram in Lucidchart, and the size of the frame selected in Confluence, your diagram may have margins (white space). Please see the example below:

Please Note: The size of the canvas within Lucidchart will not affect the amount of white space displaying within Confluence.

The below Lucidchart diagram is fairly wide.


If inserted in Confluence Server without making any changes to the size of the frame, the frame will adapt to the diagram’s size and there will be minimal white space.


However, that diagram is quite large and you likely don’t want it taking up that much space on the Confluence page, so let’s make the frame smaller. If you go into edit mode of the Confluence page and select the diagram, the below menu will pop up. No changes have been made yet, so the frame size is currently set to “original”, meaning the frame has adjusted to fit the size of the diagram.


If we take a look at the diagram’s properties (select properties option) we can see that original sizing is reflected: the width and height aren’t uniform. The frame has auto-sized to fit the diagram.


If you’d like to make the frame size smaller, go back to the below menu and select either small, medium, or large. For this example, we will select medium. 


After selecting medium, if we happen to take a look at our properties again, we’ll see something has changed. The width and height are now both 600px. This is a preset frame size that is associated with the “medium” option. This means the frame is fixed at that size. Now when we publish the page, rather than the frame adjusting to fit the size of the diagram, the diagram has to adjust to fit the size of the frame. 


Since the example diagram is wide, fitting it in a 600x600 frame is going to result in white margins above and beneath the diagram.


If you don’t want margins, there is a method of removing them. If you navigate back to your properties menu, you can customize the height and width. The example diagram had white space above and beneath it, so let’s lower the height from 600 to 300, select “save”, and then publish the page.


We can now see the white margins have been removed and we have been successful in altering the frame size so the diagram no longer takes up the entire Confluence page.


If you’d prefer, you can skip straight to the frame customization immediately after you insert a diagram in Confluence Server, but it may be useful to see what the diagram looks like in one of the standard sizes in order to better determine what width and height may work the best.