Defects: Defect URLs

Defect URLs are an easy and universal way to link TestRail to bug trackers and project management tools. Once the defect URLs have been configured, TestRail allows you to jump to your bug tracker's New Bug page to enter new bug reports. Entered defect IDs are also automatically linked to your bug tracker to make it easy to track and follow the status of reported issues.

Configuring the integration

The URL integration with bug trackers and other external tools can be configured globally or on a per-project basis. You can also specify a global bug tracker and override it for just a few specific projects. To configure a global bug tracker, select Administration > Site Settings > Integration and enter the web addresses of your bug tracker.

Defect View Url
This is the web address of your bug tracker to view a case. Use %id%
as the placeholder for the case ID. E.g., if a bug is accessed with the
address http://server/view.html?1234, enter http://server/view.html?%id%
here.

Defect Add Url
This is the web address of your bug tracker to add a case. You can usually
just enter the address of your bug tracker's add form here.

To configure a bug tracker for a specific project, edit the project and enter the web addresses of your bug tracker on the Integration tab.

How it works

Once the defect 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 quickly jump to your bug trackers New Bug form to report a new bug. Additionally, entered issue IDs are linked to your bug tracker instance to make it easier to track the status of your issues.

Examples

Please see below for links to sample URLs for popular bug trackers and project management tools. If you use one of the listed tools, you can just copy & paste the sample URLs and the following documentation will also list any other integration mechanisms we support for these tools.

Supported placeholders

You can use different placeholders for the defect URLs to send additional information to your bug trackers. Please see below for the supported placeholders.

Add URL:

  • %project_id% - The ID of the current project
  • %project_name% - The name of the current project
  • %run_id% - The associated test run ID
  • %run_name% - The associated test run name
  • %run_config% - The configuration of this test run, if any
  • %test_id% - The ID of the test
  • %test_title% - The title of the test
  • %case_id% - The ID of the related test case
  • %case_title% - The title of the related test case

View URL:

  • %id% - The ID of the defect/bug