Tools: JIRA Cloud (OnDemand)

TestRail provides a rich and unique integration with JIRA Cloud to push bug reports to JIRA during testing, link issues to test results, look up issue details from TestRail and full requirement coverage integration.

Additionally, with TestRail's unique Atlassian Connect add-on, you can directly see linked test results and test case links inside JIRA, review metric dashboards and create new test cases from JIRA. Learn more about TestRail's rich JIRA Test Management integration.

1. Get TestRail Instance

Already using TestRail? You are all set and you can skip this step! If you are not yet using TestRail, simply register your free trial. You can either get TestRail Server for a local installation or use TestRail Cloud on our servers. For JIRA Cloud we also recommend our TestRail Cloud edition, but you can choose whichever edition you prefer.

2. Configure JIRA integration in TestRail

Configuring the JIRA integration in TestRail is easy. Simply select Administration > Integration to configure your settings. We recommend using the simple JIRA configuration wizard at the top of the page. Simply click the Configure JIRA Integration button to get started:

This will automatically help you set up the required JIRA URLs, the defect integration to push/lookup JIRA issues as well as the reference/requirement integration.

The wizard also automatically configures the integration with User Variables so that each user can enter their own JIRA integration settings (otherwise the entered fallback user is used). To configure the JIRA user, each user can simply enter the details under their My Settings page by clicking on their name in the top right corner of the TestRail interface.

Note: If your team is using Jira Cloud, your users will need an API token instead of your Jira password in order to successfully use integration features. An API token for Jira Cloud can be created here.

Each user can simply enter her/his JIRA login details for the integration. Please make sure that the users enter their email address for the integration.

Manual JIRA configuration

Do you prefer to configure the JIRA integration manually or need to customize, extend or change the integration? No problem, you can also easily configure the JIRA integration from TestRail's side manually with a few simple steps.

You can also configure different integrations for different projects. To do so, simply configure the integration for each project under Administration > Projects > edit a project > Defects / References tabs. Learn more about configuring the integration manually or how to customize and adjust the integration here:

3. Add-on for JIRA Cloud

The optional (but highly recommended!) Atlassian Connect add-on for JIRA Cloud allows you to directly review related test results, test case links, TestRail dashboard statistics and new case buttons directly from inside JIRA. To get started, simply activate the TestRail add-on for JIRA Cloud from the Atlassian Marketplace:

Alternatively, you or your JIRA administrator to enable the add-on directly from JIRA under Settings > Apps > Find New Apps, then search for TestRail. From there, click the TestRail app > Get App > Get It Now.

Next, simply configure the add-on with your TestRail address and key. From JIRA's administration area, select Manage apps, expand the TestRail for JIRA Test Management app and click Configure. Then simply configure your TestRail address and integration key and any additional optional settings.

You can also limit the add-on to select JIRA user groups or projects to hide the integration from users who don't currently use TestRail.