Skip to main content
InVision Support Home Page
Sign in
  1. InVision Support
  2. Knowledge Base
  3. InVision Platform
  4. Integrations

Integrating InVision with Jira Server and Data Center

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

With InVision for Jira Server and Data Center, you can preview, comment on, and inspect prototypes—all without ever leaving Jira. InVision for Jira 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. At the top right of your Jira homepage, click your profile icon, and then click Atlassian Marketplace.
    jira-server-marketplace.png
  2. Search for the InVision for Jira app, and click Install.
    jira-server-install.png
  3. Click Accept & Install.

Configuring the app

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

To configure which projects will use the InVision app:

  1. At the top right of your Jira homepage, click your profile icon, and then click Atlassian Marketplace.
  2. In the left-hand navigation, click Manage apps. 
  3. Expand the InVision for Jira app and click Configure. 
  4. Check the box Limit to Projects, and then select the projects where you want to use InVision.
  5. Click Save.
jira-server-configure-app.gif
Currently, it’s not possible to limit by issue type or other conditions.

Allowlisting 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 allowlist your Jira Server or Data Center instance in InVision Cloud V6.

To allowlist your Jira Server or Data Center instance, you must be an admin on the InVision Enterprise account.

To allowlist Jira Server or Data Center:

  1. Sign in to your InVision Cloud V6 Enterprise account and navigate to the People page. 
  2. Next to the Teams tab, click ••• (more), and then click Manage Allowlist Domains.
    manage-allowlist-domains.png
  3. Enter the domain for your Jira Server or Data Center instance, and click Add. 
    add-allowlisted-domain.png
If you have multiple InVision Enterprise or Private Cloud accounts on InVision Cloud V6, you will need to repeat these allowlisting steps in each InVision instance.

Attaching a prototype

Currently, it's not possible to attach password-protected prototypes.

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.

jira-server-attach-prototype.gif
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, you will need to be signed 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 preview without commenting or inspecting capabilities, 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.
jira-server-interacting-with-prototype.gif

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).

jira-server-disconnect-prototype.gif

Known limitations

There are currently a few known limitations for the InVision for Jira Server and Data Center apps:

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

Related articles