By connecting InVision with Jira, we’re closing the gap between design and engineering, making it easier to work together. With this integration, designers save time by keeping just the prototype up to date—instead of the prototype, Jira issue, and screens. Engineers stay current with the latest designs, leaving more time to iterate on the important things that make your product successful.

Integrate InVision and Jira by pairing an InVision prototype with a Jira issue. Once a prototype is attached, a Jira issue will display a visual preview of the prototype. From here, you’ll be able to view, comment, and access Inspect for your prototype.

The InVision for Jira integration is available as add-on for both Jira Cloud and and Jira Server. In Jira Server, the add-on works in all Atlassian supported major versions of Jira (two years after the first major iteration of that version was released e.g. Jira Core 7.0.x for 2 years after Jira 7.0.0 was released).

Installing the integration

You must have Jira admin privileges to install the add-on.

To install the integration in your instance of Jira:

1. From your Jira dashboard, click the cogwheel at the top right.
2. Click Add-ons to visit the Atlassian plugin marketplace.
   
3. Search “InVision” from the search bar. (Alternatively, you can just view and install the InVision app in the Atlassian Marketplace here.)
4. Click the green Try it free button to install the add-on.

Choosing projects the integration appears in

You can now choose which projects the InVision Jira plugin gets added into. To configure that:

1. Within the "Administration" page, select Add-Ons then Manage Add-ons.
2. Select the "InVision for Jira" add-on.
3. Click Configure.
4. Enable the Limit to Projects option and select the projects you want to make the add-on available within

Note: You cannot yet filter based on issue type or other conditions.

Installation for Enterprise Private Cloud

InVision for Jira Version 1.2 and later supports Enterprise for Private Cloud. The exact steps you'll need to take to get our Jira integration working properly depend on whether you're using Jira Cloud or Jira Server.

Jira Server

If using Jira Server, a Jira Admin will need to switch the standard URL https://projects.invisionapp.com with their private cloud URL. For example, https://companyname.invisionapp.com. It's critical that you do these steps if you're a Private Cloud customer.

1. Click Configure under InVision for Jira.
2. Enter your company's URL in the Server URL field.
3. Click Save configuration.
   

Jira Cloud

If using Jira Cloud, you need to do the following:

1. In Jira, go to Add-ons > Manage Add-ons.
2. Click Upload add-on. (In order to see the "Upload add-on" link, you may have to click on Settings and then enable development mode.)
   
   

   

3. Enter the following URL, substituting the sub-domain of your Private Cloud instance for the value in brackets: https://[yourdomain].invisionapp.com/jira-bff/atlassian-connect.json

   For example, if your InVision Private Cloud sub-domain was “yourcompany”, you should enter https://yourcompany.invisionapp.com/jira-bff/atlassian-connect.json

    

   

4. Click Upload to finish installing the InVision add-on for Jira Cloud.

Attaching your prototype

To attach your prototype with your Jira issue:

1. Go to your InVision prototype and create a share URL.*
2. Go to your Jira issue and enter the URL in the integration section under the Description section.
   
3. Click Attach prototype.
   Note: If you encounter the error message, "Dang it! There was a problem with that URL. Please input a prototype's share URL," that message indicates a permissions issue. Here are instructions for correcting the permissions configuration.
4. A preview of your prototype will appear.

*Alternatively, you can create a share URL for a single screen or specific selection of screens; however, it's important to note that to maintain the selection of screens, currently you must click the image thumbnail in Jira and navigate the prototype using your keyboard arrows. At the moment, clicking Preview, Comment, or Inspect in Jira will display the entire prototype. 

Prototype information

Once your prototype is paired, you’ll be able to see a prototype preview, as well as some additional information about your prototype, as seen in the example below. The share link is dynamic, so anytime you make changes to the prototype in InVision, they’ll be reflected in the Jira issue.

Clicking the Preview button will open your prototype in InVision. If you click the Comment button, your prototype will open in a new tab or window in Comment Mode. Click the Inspect button to open your prototype in Inspect Mode in InVision. Clicking on the thumbnail preview will open the share link in a new browser tab so that it is possible for a user that does not have access to InVision to be able to view the prototype.

Known limitations

There are currently a few known limitations for our Jira add-on:

• We currently do not support the add-on for Jira Server instances configured with a proxy.
• The Jira Server add-on requires internet access to reach InVision servers.
• The add-on requires your Jira Servers have SSL configured.