×

Unable to link prototype via InVision for JIRA add-on

Issue

When attempting to link a prototype using the InVision for JIRA add-on, you may encounter an error that reads "Dang it! There was a problem with that URL. Please input a prototype's share URL." as shown below:

This issue can occur when the user attempting to link a prototype lacks permissions to edit issues in that JIRA project. When that happens, the integration is unable to link the prototype to the issue and it fails with the above error message.

Solution

There are two ways to address this problem:

  1. Add "Edit Issues" permission for users who will be attaching prototypes
  2. Use JIRA's "Permission Helper" to diagnose the permissions issue

Option 1: Add "Edit Issues" permission for the user(s) attaching prototypes to tickets via the JIRA add-on

For basic permission schemes in JIRA, this issue can usually be addressed by simply giving the user(s) attaching prototypes to tickets via the JIRA add-on permission to edit issues in each of the JIRA projects where you'll be using the add-on. There are a few different ways to do that depending on your permission structure in JIRA, but the easiest is to add the "Edit Issues" permission for the individual user(s).

To do that, an administrator in your JIRA instance will need to do the following:

  1. Open the JIRA project where you're having trouble

  2. Click the "Project settings" gear icon in the left sidebar as seen below:

  3. Click Permissions in the left sidebar

  4. Click on the "Actions" dropdown in the upper right and click Edit permissions

  5. Scroll down to "Edit Issues" under "Issue Permissions" and click Edit

  6. In the "Grant permission" modal that appears, click Show more to expand the types of permissions grants available

  7. Select "Single user" and search for the user's name to give that user permission to edit issues as shown below:

Grant_Permission_modal_2x.png

8. Click Grant to save your changes

Once you've granted the user the permission to edit issues you should be able to then link InVision prototypes in that JIRA project as well as any other JIRA projects that use the same permissions scheme.

Note: If you use different permissions schemes for different JIRA projects, you may need to repeat the above steps multiple times for each permissions scheme you have.

Option 2: Use JIRA's "Permission Helper" to diagnose the permissions issue

The prior option may not work for more complex permission schemes. If the steps outlined above don't work, then you'll need to check your permissions and determine why the user still lacks the necessary "Edit Issues" permission. Fortunately, Atlassian provides a convenient tool called the "Permission Helper" that can be used to sort out permissions issues like this. To use it:

  1. Log in to JIRA as an administrator
  2. Open the JIRA project where you're having trouble

  3. Click the "Project settings" gear icon in the left sidebar as seen below:

  4. Click Permissions in the left sidebar

  5. In the upper right, click Permission helper as shown below:

  6. Enter the following values:

    • User: User's name
    • Issue: The issue key (e.g. SUPPORT-1234) in which you're unable to link an InVision prototype
    • Permission: Edit Issues
  7. Click Submit to see whether the user is able to edit the issue in question and click Show failed conditions to reveal why if the user doesn't have sufficient permissions

If a permissions issue is identified it'll look something like this:

Permission_Helper_modal_2x.png

How you fix a permissions issue that's identified by the above tool depends on the nature of the issue. You'll need to consult Atlassian's documentation or work with their support if you're not sure how to address a permissions issue identified by their "Permission Helper" tool.

If the "Permission Helper" doesn't identify any permissions issues but you still cannot link a prototype, please contact InVision Support and we'd be happy to assist. Please attach a screenshot of the "Permission Helper" results as this contains details that can be helpful for troubleshooting the issue.