Jira Server Setup

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

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

Need help? Contact us today.

Step 1: Install the Lucidchart plugin

  1. Log into your JIRA instance as an Admin.
  2. Click the gear icon, select “Add-ons,” then 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.

Step 2: Configure the plugin

  1. After installing, click “Manage” and “Configure” to grant Lucidchart access to JIRA.
  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” 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 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

How to use the Lucidchart add-on for JIRA Server

To attach a diagram to an issue

  1. Navigate to any JIRA 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 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 to request editorial access.
  3. Click "Return to JIRA" when you're done editing. The attached diagram will update automatically.
  4. To delete a diagram attachment, click the trash icon. This will not delete the diagram from Lucidchart’s website.

Refreshing an attached diagram

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

You’re now ready to start using Lucidchart for JIRA Server. If you have any questions, just send an email to support@lucidchart.com.

Over 6,000,000 users

trust Lucidchart to keep them on the same page.

Find Out Why