Jira Software Server Setup

Lucidchart for Jira Software Server is a comprehensive diagramming solution for your entire team. Watch this video to learn how to install and configure the add-on.

Play Video
Get a quote Switch to Jira Software Cloud

Team and Enterprise users can install our Jira Software Server connector at no extra cost. Upgrade your account today or start a free trial to install the connector.

Easy to set up:

  1. Start your team account
  2. Install the Lucidchart connector
  3. Configure to your instance
Install the Lucidchart connector

Step 1: Install the Lucidchart connector

  1. Log into your Jira Software instance as an Admin
  2. Click the gear icon, select “Add-ons,” and choose “Find New Add-ons”
  3. Search for “Lucidchart” and click “Install.” Follow the instructions to complete installation, and then close the dialogue box
  4. Alternatively, you can install Lucidchart from the Atlassian Marketplace
Configure the connector

Step 2: Configure the connector

  1. After installing, click “Manage” and “Configure” to grant Lucidchart access to Jira Software
  2. On this page, you should see fields for an API Key & Secret pair. Click the link to go to your Lucidchart Team Management page, and choose the gray “Manage Jira Software” button. You'll see a window with fields for an API Key & Secret and blue links to helpful documentation
  3. If you do not have a Jira Software key and secret, press the “Generate New API Key Pair” button. Copy the API key & secret, and paste into the provided field
  4. Hit save
Attach a Lucidchart diagram

How to use the Lucidchart add-on for Jira Software Server

To attach a diagram to an issue

  1. Navigate to any Jira Software issue and select "Attach Lucidchart Diagram" from the "More" drop-down menu
  2. In the resulting pop-up window, choose to insert an existing diagram, create a new one, or import a Visio, Gliffy, draw.io, or OmniGraffle document directly
  3. A new panel will appear on the issue page that contains all diagrams attached to it

To view an attached diagram

  1. Simply click a diagram’s thumbnail to open it in a full-screen viewer

To edit or delete an attached diagram

  1. Move your mouse pointer over a diagram and click the "pencil" icon to open a full-screen editor
  2. If the icon is disabled, this means you don't have the permission to edit the diagram. Contact the person who owns the diagram request editorial access
  3. Click "Return to Jira Software" when you're done editing. The attached diagram will update automatically
  4. To delete a diagram attachment, simply click the trash icon. This will not delete the diagram from Lucidchart website

Refreshing an attached diagram

  1. If you attach a diagram to Jira Software and somebody else edits it on Lucidchart's website directly, the attached version will not update automatically. Click the "refresh" icon to manually update the attachment

Now, you have learned how to use Lucidchart for Jira Software Server. If you have any further questions, just send an email to support@lucidchart.com and we'll be glad to help.