Our integration with the project tracking tool, Jira, enables feedback items to be automatically or manually pushed to a specific project. This means you can easily push bugs or feature requests identified by your users to the teams responsible for solving them.
Pushing feedback to your Jira project can also be very helpful for filling your Kanban board and prioritizing stories.
Note: At the moment, this integration can only be set up for Usabilla for Websites and for the Feedback retrieved by your Feedback buttons.
This guide consists of:
- Requesting an Atlassian API token
- Setting up the Jira integration in Usabilla
- How to manually push Feedback from Usabilla to Jira
- Integration with Jira on-premise/self-hosted instances
- Troubleshooting
- An example
What do you need:
- A Usabilla account with an Administrator/Power User role
- An active Usabilla Button
- An Atlassian API token
Requesting an Atlassian API token
Let's start with requesting the API token you'll need to enable this integration:
- Log in to https://id.atlassian.com/manage/api-tokens
- Select "Create API token"
- Enter a name for the token you're about to create that will help you remember what the token will be used for
- Click the "Copy to clipboard" button and store it somewhere safe so we can use it in the next step of the setup
Setting up the Jira integration in Usabilla
Note: Let's start by making sure you're using Jira Cloud, if you are, continue with following these steps. If you're trying to set up the integration for a Jira on-premise instance, click here.
- Open a new browser tab and go to http://app.usabilla.com
- Login into Usabilla with your credentials.
- Click on your username in the top-right corner (1.) and click on "Account Settings" in the drop-down (2.): 
- In the Account Setting, navigate to the Live integrations tab (1.) and select the Jira logo (2.): 
- Next, you will be prompted with a window for setting up your Jira integration with the following options: 
Button: Select the button you would like to create the Jira integration for.
Push Feedback: Select when you would like Usabilla to push the feedback response. The options are:
- When the feedback response has an email address
- When the feedback response has a comment
- When the feedback response has an email address or comment
- Send all feedback responses
- Manual push
Url: Enter your Jira subdomain (e.g. https://[subdomain].atlassian.net).
- You do not need to include "https://" and ".atlassian.net".
Token Access: Click on our tool to generate a token, after clicking this enter the following credentials:
- Username: Enter your Jira username, in most cases, this will be an email address
- Password: Enter the API token that was requested at the beginnning of this article here.
Issue Type: Enter the preferred issue type (by default it's "Improvement").
- Issue types can be managed in Jira here: https://[subdomain].atlassian.net/secure/admin/ViewIssueTypes.jspa
Project Key: Enter the Jira project key.
- This is the project name found capitalized on the top left, after logging in.
Check "Enable" to activate the Jira integration for the selected button.
- You can always disable it later.
Click save and your Jira integration is ready.
How to manually push Feedback from Usabilla to Jira
When you have selected manual push, you can find the Jira integration on every feedback details page (that belongs to the button you have activated the integration for). Click the "Jira" link like displayed in the image below and a bug will be issued in Jira for this feedback item. All necessary data will be included in the ticket. 
Note: Each Feedback item can be pushed to Jira once. Feedback items that were pushed to Jira can be recognized by a green checkmark.
You can always edit your integration later to change the configuration or to disable/enable the integration. Don't hesitate to reach out to our support team if you run into any questions or issues.
Integration with Jira on-premise/self-hosted instances
If you are using Jira on-premise you will need to provide access to the Usabilla servers in order to make the integration work. In many cases, your JIRA on-premise instance will be cut-off from the internet and will only be available when you are connected to the company network e.g. you can only access it when connected with the company VPN or when you are at the office.
To allow the Usabilla servers to connect to your Jira instance you will need to whitelist the IP addresses of the Usabilla Server. The Usabilla Server uses 3 IP addresses. You'll likely need to contact your network administrator to have these IP addresses whitelisted. Please contact your Usabilla contact person for the exact IP addresses and Ports that need to be whitelisted.
Troubleshooting
When setting up the integration you'll need to watch out for a couple of things. First, you'll need to make sure that you fill out all the fields correctly. In the screenshot below we highlight how each of the fields needs to be filled out. It's important that all the fields are filled out correctly since having the incorrect values can result in either the authentication for the integration being rejected or the push of the feedback being rejected.
Example
Awesome, if all went well you've just set up an integration between your Jira instance and you Usabilla feedback button. To give you a basic idea of how the integration will look like we've added two screenshots below. One show you how the manually pushing of feedback within Usabilla will look like and one screenshot show you how feedback will look in your Jira environment that has been pushed to a Jira business project. The pushing of feedback works for both business- as well as software projects.
Tip: When setting up the integration you have several options for pushing feedback. In order to achieve the right amount of granularity in the pushed feedback, make sure you select a method for pushing feedback to Jira that fits the needs of your organization.
