Tools: JIRA manual configuration

We usually recommend using our easy integration wizard for JIRA from TestRail's Administration area under Administration > Integration. Simply select the relevant article below to get started:

You can alternatively configure the integration manually and this also only takes a few minutes. This topic explains how to integrate TestRail with JIRA manually (both JIRA Server as well as JIRA Cloud). There are currently three ways to integrate TestRail with Jira, namely:

  • Using defect URLs to link test results to JIRA
  • Using the defect plugin for JIRA to push and look up JIRA issues
  • Using reference URLs and the reference integration to link test cases to JIRA

You don't have to use all listed integration options and you can mix and match the integration with other tools. Configuring the integration usually only takes a few minutes and this guide explains how to configure the integration and how it works.

Defect URLs

The defect URLs are used to let TestRail know how to access your JIRA instance. Once the URLs have been configured, a new Add link appears next to the Defects field in the Add Test Result dialog. This link allows you to jump to JIRA's Create Issue form to report a new bug. Additionally, entered issue IDs are linked to your JIRA instance to make it easier to track the status of your issues.

To configure JIRA's URLs in TestRail, select Administration > Integration. You can alternatively enter separate bug tracker URLs for each project under Administration > Projects. Use the following example URLs to configure the addresses:

JIRA Cloud
Defect View Url: https://name.atlassian.net/browse/%id%
Defect Add Url:  https://name.atlassian.net/secure/CreateIssue!default.jspa

JIRA installation
Defect View Url: http://your-server/jira/browse/%id%
Defect Add Url:  http://your-server/jira/secure/CreateIssue!default.jspa

Defect plugins

Defect plugins can be used to implement a deeper bug tracker integration and TestRail comes with ready-to-use JIRA defect plugins. The JIRA integration plugins have been split out into two separate plugins to handle cloud and server Jira integrations separately. As of 29th April 2019, Atlassian deprecated user password functionality in their cloud version of JIRA so as to align with European GDPR regulations. For TestRail, this means that cloud and server JIRA integration need to be treated somewhat differently. In a nutshell:

  • For JIRA server integration, you should use the “JIRA REST” (JIRA Server 5.x, 6.x, 7.x and later) plugin, and authenticate the integration using your JIRA username and password combination.
  • For JIRA cloud integration, you should use the “JIRA Cloud” plugin, and authenticate the integration using your JIRA email address and JIRA API token.

To configure the defect plugin, select Administration > Integration and select the relevant JIRA defect plugin in the Defect Plugin dropdown list. The next step is to configure all the necessary connection settings in the Configuration field. Project specific plugins and configuration settings can optionally be specified under Administration > Projects.

When the defect plugin has been configured, a new Push link is shown next to the Defects field in the Add Test Result dialog. Clicking the link will open a popup dialog that enables you to push a bug report to Jira without leaving TestRail. Once the test result was added, hovering the mouse cursor over an issue ID will open a window with useful information and status details about the issue in Jira.

Reference URLs

The reference URLs are used to link test cases to issues stored in JIRA via the References field. Once the URLs have been configured, issue IDs entered in the References field are linked to your JIRA instance to make it easier to jump to related issues, feature specifications or requirements.

To configure JIRA's URLs for the References field, select Administration > Integration. You can alternatively enter separate reference URLs for each project under Administration > Projects. Use the following example URLs to integrate TestRail with JIRA:

JIRA Cloud
Reference View Url: https://name.atlassian.net/browse/%id%
Reference Add Url:  https://name.atlassian.net/secure/CreateIssue!default.jspa

JIRA installation
Reference View Url: http://your-server/jira/browse/%id%
Reference Add Url:  http://your-server/jira/secure/CreateIssue!default.jspa