Help Center

Every little secret about Usersnap

Connecting Usersnap with JIRA

JIRA and Usersnap can be easily connected.

Usersnap can connect to your JIRA Software and Service Desk projects via JIRA Cloud or JIRA OnPremise.

Here's how it works:

Log in to your Usersnap account or sign up for a free trial.

Go to your Usersnap project’s 3rd Party Integration tab and select JIRA from the grid.

Integration 3rd party usersnap jira

Choose the kind of JIRA installation you have, JIRA Cloud or JIRA OnPremise, and enter the credentials of the user and the hostname of your JIRA installation.

Integration usersnap jira cloud or on-premise

For security reasons it is highly recommended to configure a specific JIRA user which is only allowed to create issues (e.g. name the user "usersnap_feedback"). For detailed information about how to configure restricted users, please visit the JIRA documentation.

create jira user for usersnap

After entering your JIRA credentials, click on "Connect now!".
You can now choose the JIRA Software or Service Desk project where you want to send your Usersnap screens, the issue type (bug, task, improvement, etc.) and which priority level the issue should have.

connect jira with bug tracker from usersnap

Click ‘Save’ and start sending your Usersnap screens directly to your JIRA project.

JIRA ticket Usersnap screenshot

Using GoogleApps authentication with JIRA

If you are using JIRA OnDemand with Google Apps integration, you need to know that there are two different login credentials - the JIRA-User and the Google-User.

Usersnap uses the JIRA API, therefore you need to enter your OnDemand-Password. You can set or change your OnDemand-Password here:

Changing your Password in Atlassian OnDemand.

Please note that your username will be only the part before the “@” of your login email address.
Example: yourname is the username if is your email address.

Common Problems

There are common issues encountered when connecting Usersnap with JIRA.

Missing permissions of the connected account

Please make sure that the account used to connect Usersnap with JIRA has the "Create Issue" project permission for the JIRA project you are connecting with Usersnap. You can find further information on how to manage project permissions in the JIRA documentation.

Missing fields in the screen configuration

Usersnap uses the following fields to define an issue. Please make sure that these fields are defined for the target screen of the project

  • Summary
  • Description
  • Please use the JIRA Documentation to find out how to configure screens add the mandatory fields.

    configure JIRA ticket

    Setting correct field configurations

    Other fields (such as those below) should be set to optional in your JIRA field configuration settings as these fields cannot be defined automatically by Usersnap.

    Please use the JIRA Documentation to find out how to configure fields and set them to 'optional'.

  • Priority (optional)
  • Reporter (optional)
  • Environment (optional)
  • jira field configuration

    Allowing Attachments

    Because a Usersnap screen is sent to Jira as an attachment to the JIRA issue created, attachments have to be allowed in your Jira settings.

    Go to Administration>Projects, choose your project and click on the 'Permissions' tab. From the 'Actions' menu, click on 'Edit Permissions'" and go to the 'Attachments permissions' settings.

    jira field configuration

    Under 'Create Attachements', configure your settings to grant 'Create Attachments' permission to any logged in user.

    jira field configuration

    Need more help connecting Usersnap to JIRA?

    Drop us an email and say hi to our team!

    using usersnap tutorial
    Customer support using usersnap tutorial how to

Usersnap helps you build great digital products.

With Usersnap Feedback, Chat and Track, you'll get everything you need for building digital products.