Tools: JIRA Server 5.x, 6.x or 7.x
TestRail provides a rich and unique integration with JIRA Server 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 JIRA Server 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. If your JIRA Server instance is running on your private network behind a firewall, then we also recommend our TestRail Server edition. If your JIRA instance is reachable over the Internet, you can also use our TestRail Cloud edition (we can also provide the list of our cloud IPs for the integration if required by your IT team).
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.
Each user can simply enter her/his JIRA login details for the integration. Please make sure that the users enter their JIRA username and not 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 Server
The optional (but highly recommended!) JIRA Server add-on 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 Server from the Atlassian Marketplace:
Alternatively you can simply ask your JIRA administrator to enable the add-on directly from JIRA under Add-ons > Search for TestRail > Activate the add-on.
Next, simply configure the add-on with your TestRail address and key. From JIRA's administration area, select Manage add-ons, expand the TestRail for JIRA Test Management add-on 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.