[[ rootSection.name ]]
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:
- At the top right of your Jira homepage, click your profile icon, and then click Atlassian Marketplace.
- Search for the InVision for Jira app, and click Install.
- 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:
- At the top right of your Jira homepage, click your profile icon, and then click Atlassian Marketplace.
- In the left-hand navigation, click Manage apps.
- Expand the InVision for Jira app and click Configure.
- Check the box Limit to Projects, and then select the projects where you want to use InVision.
- Click Save.
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:
- Sign in to your InVision Cloud V6 Enterprise account and navigate to the People page.
- Next to the Teams tab, click ••• (more), and then click Manage Allowlist Domains.
- Enter the domain for your Jira Server or Data Center instance, and click Add.
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
To attach a prototype to a Jira issue:
- Open your prototype in InVision and create a public share link.
The steps to create the share URL will depend on the version of InVision you're using.
If you're on V7, follow these steps to create a public link.
If you're on V6, follow these steps to create a share link instead.
Not sure which version you're using? Find out here. - Navigate to your Jira issue and, under the InVision section, enter the share URL.
- Click Attach prototype.
An interactive preview of your prototype will appear.
Currently, it's not possible to attach password-protected prototypes.
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 (
). 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 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 (
).
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.
