Skip to main content

Linking Test Cases to Issues

Linking test cases to issues creates a traceable connection between a bug and the test that verifies it is fixed. This is essential for quality assurance workflows — it lets your team know exactly which tests to run when a fix is ready.

  • Traceability — know which tests cover which bugs
  • Regression prevention — when an issue is re-opened, you know immediately which test to run
  • QA handoff — developers can hand off a fixed issue to QA with the relevant test cases attached
  • Coverage visibility — see which issues have test coverage and which do not

Linking a test case to an issue​

From the test case​

  1. Open the test case.
  2. In the Linked Issues section, click Link Issue.
  3. Search for the issue by title or ID.
  4. Select the issue from the results.
  5. Click Link.

The issue appears in the test case's Linked Issues section.

From the issue​

  1. Open the issue.
  2. Scroll to the Test Cases section.
  3. Click Link Test Case.
  4. Search for the test case by title.
  5. Select it and click Link.

One-to-many relationships​

A single test case can be linked to multiple issues (e.g., the same login test might cover several auth-related bugs). Equally, a single issue can have multiple test cases linked to it.

Running linked tests from an issue​

When an issue is fixed and ready for verification:

  1. Open the issue.
  2. Go to the Test Cases section.
  3. See all linked test cases with their last run result and date.
  4. Click Run next to a test case.
  5. Follow the test steps and record the result (Pass / Fail / Blocked / Skip).

This workflow keeps the QA process organized — everything needed to verify the fix is in one place.

Test case run history on an issue​

Each linked test case shows:

  • Last run result — Pass (green), Fail (red), Blocked (yellow), Not run (grey)
  • Last run date — when it was last executed
  • Run count — total number of times this test has been run against this issue

This history helps your team understand whether a fix is stable or if it keeps failing.

Linking test data to a test case​

If a test requires specific test data:

  1. Open the test case.
  2. In the Test Data section, click Link Test Data.
  3. Search for a test data set.
  4. Select it and click Link.

Testers can then open the linked test data set directly from the test case before running the test.

See Managing test data sets.

From the test case:

  1. Open the test case.
  2. In the Linked Issues section, find the issue.
  3. Click the Unlink (×) button next to it.

From the issue:

  1. Open the issue.
  2. In the Test Cases section, find the test case.
  3. Click Unlink.

Removing a link does not delete either the test case or the issue.

Viewing test coverage across a sprint​

To see which issues in a sprint have linked test cases:

  1. Open the sprint.
  2. Switch to List view.
  3. Look at the Test Coverage column. Issues with linked tests show a green check; those without show a grey dash.

Issues without test coverage may be a signal that they need test cases written before the fix is considered complete.