Link Jira Story/Issue to Existing Test Cases

Link Story to Existing Test Cases

Users can link existing test cases directly with the stories in Jira. Test Cases from cross-projects can also be linked to the stories.


1. Open a Jira issue detail page. If QMetry for Jira Add-on is configured with Jira, you should see the Test Case/Acceptance Criteria panel.

2. If the panel is hidden, then click on the ellipsis (...) icon and select Test Case/Acceptance Criteria.


To link existing test cases to the story in Jira, click on the ellipsis (...) icon on the Test Case/Acceptance Criteria section and select (A) Link Existing Test Cases.

If there is not a single test case linked to the story, you can also view the (B) Link Existing Test Cases link below the No Test Cases text.

The Link Existing Test Cases screen opens. Users can sort test cases on the Version column which helps them pick the test cases on the basis of their versions. For example, testers has to link Version 2 of test cases to the story.

Display Test Cases of Sub Folders

Users can opt to show/hide test cases from sub folders at parent folder. By default, the Display Test Cases of Sub Folder(s) option remains disabled for new projects and new users. The test cases from sub-folders remain hidden at parent folder level on the test case list view. To display the child test cases, open the More options menu on the test case tree at left, and select Display Test Cases of Sub Folder(s).

Use Case: QA team manages test cases under multiple folder hierarchy. While linking test cases to Jira story/issue, testers need an ability to view all test cases present in the sub-folders along with the test cases of parent folder. They can directly fetch the list of the test cases from the parent folder, instead of navigating to the sub-folders.

  • The set preference is applied to all the screens from where the test case module list opens up.

  • If the same test case is part of multiple sub-folders, then it is displayed only once at parent folder.

Filter Test Cases:

A. You can browse test cases as per the test case folder on the tree. It will help you narrow down the test case search.

B. If the test case list is long, apply filters to the list. You can filter records through search. You can search a particular test case by "Issue Key" or “Summary” through the search box.

C. There are more options like Labels, Fix Versions, Sprint, Components, Status, Priority, etc. to narrow down the search.

Note: A maximum of 10 filters, including system as well as custom fields, can be selected at a time.

  • Hide Already Linked Test Case: Check the Hide Already Linked Test Case to avoid the display of those test cases on the screen which are already linked to the Jira issue. It prevents the linking of the same test cases with the same Jira issue again.

Select the test cases you want to link with the Jira issue and click either of the buttons:

  • Link: Select the test cases you want to link with the Jira issue/story and click on the Link button. Once test cases are linked, the Link Existing Test Cases screen still remains open to let you link further test cases.

  • Link & Close: You can link test cases with the Jira issue/story and close the pop-up. Select the test cases to be linked with the Jira issue/story and click on the Link & Close button.

The test case sequence will be preserved as per the order of selection while linking to the story.

You can see the test cases are linked to the Jira issue.

Users can link multiple versions of a test case to the Story and trace the test case linkages with the story.

View/Add/Edit/Clone/Delete Test Steps from Jira Story

Users can add new test steps and edit existing test steps from the Story details page. Expand the test case and open the Step Detail tab. The section is editable wherein you can add new steps or make changes in the existing details of steps. The changes reflect in the Test Case module.

Users can also Clone/Delete test steps from the Jira story page.