Tools: JIRA Server 3.x or 4.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: