Sorry, the InVision Help Center does not support Internet Explorer. Please download Microsoft Edge or another modern browser.

Integrating InVision with Jira Server

This article is specific to InVision for Jira Server. If you are using Jira Cloud, check out this article instead.

With InVision for Jira Server, you can preview, comment on, and inspect prototypes—all without ever leaving Jira. InVision for Jira Server works for all major versions of Jira that Atlassian supports.

Installing the app

To install the app, you must have Jira admin privileges.

To install the app in your instance of Jira:

  1. From your Jira home page, navigate to the bottom left and click the settings icon (jira-settings-icon.png).
  2. Click Apps.
  3. In the search bar, search for “InVision.”
  4. In the list below the search bar, click the InVision for Jira app.
  5. Click Get it now.

For a direct link to the app in the Atlassian Marketplace, visit this link.

Configuring the app

To configure the app, you must have Jira admin privileges.

To configure which projects will use the InVision app:

  1. From your Jira home page, navigate to the bottom left and click the settings icon (jira-settings-icon.png).
  2. Click Apps.
  3. In the left sidebar, click Manage apps.
  4. From the list of User-installed apps, click InVision for Jira.
  5. Click Configure.
  6. Check the box Limit to Projects, and then select the projects where you want to use InVision.
  7. Click Save.
Currently, it’s not possible to filter by issue type or other conditions.

Whitelisting in InVision Cloud V6 (Enterprise only)

If you're using InVision Cloud V6 and you're an Enterprise or Private Cloud user, it's important that you whitelist your Jira Server instance in InVision Cloud V6.

To whitelist your Jira Server instance, you must be an admin on the InVision Enterprise account.

To whitelist Jira Server:

  1. Sign in to your InVision Cloud V6 Enterprise account and navigate to the People page. 
  2. To the right of the Teams tab, click the ••• (more) button, and then click Manage Whitelisted Domains.
  3. Enter the domain for your Jira Server instance, and click Add
If you have multiple InVision Enterprise or Private Cloud accounts on InVision Cloud V6, you will need to repeat these whitelisting steps in each InVision instance.

Attaching a prototype

To attach a prototype to a Jira issue:

  1. Open your prototype in InVision Cloud and create a share URL.
  2. Navigate to your Jira issue and, under the InVision section, enter the share URL.
  3. Click Attach prototype.

An interactive preview of your prototype will appear.

If you encounter an error message, it’s likely there is a permissions issue. For more information, check out this article: Why can't I link my prototype via InVision for Jira?

Interacting with a prototype

After you attach a prototype, a thumbnail image will appear. Any time you make changes to the prototype in InVision, the changes will appear in Jira.

To preview all screens in the prototype, click the thumbnail image. Alternately, navigate to the top right of the image and click the expand button (jira-expand-icon.png). If you want to comment on or inspect the prototype, sign in to your InVision account. The sign-in modal will appear as a separate pop-up window, so please ensure that pop-ups are allowed. To just interact with the prototype, click Continue as guest.

If you're using InVision Cloud V6 and you're not an Enterprise or Private Cloud customer, you won't be able to view, inspect, or comment on standard prototypes within Jira. Instead, click the name of the prototype, and InVision Cloud will open in a new browser window. That said, you can interact with Studio prototypes within Jira.

To close the prototype, navigate to the top right and click the X button.

If you are unfamiliar with Inspect or commenting features with InVision Cloud, check out these articles:

Removing a prototype

To remove a prototype from your Jira issue, navigate to the top right of the prototype thumbnail, and click the disconnect button (disconnect-icon.png).


Known limitations

There are currently a few known limitations for the InVision for Jira Server app:

  • The app requires internet access to reach InVision servers.
  • For optimum performance, Jira Servers should have SSL configured.

Was this article helpful?

Still have a question?

Contact Us