Link Jira work items to a Test Folder to show which requirements relate to that folder. For example, connect a Checkout folder to the stories it helps test. These are folder-level relationships; manage individual Test Case links separately when you need case-level traceability.
Before you begin
You need access to the Jira space, the Test Folder, and the Jira work items you want to link.
You need Vansah permission to edit the Test Folder.
Use an existing Test Folder. This linking control is not available on the Test Repository root or while creating a new folder.
Link an existing Jira work item
Open Vansah → Test Cases in the Jira space.
Find the Test Folder in the Test Repository tree. Open its more options menu and select Properties.
In Folder properties, open Requirements - Work Items. The number beside it shows the saved link count.
Select Link / Unlink Work Items.
Choose the Jira space to search, then enter the work item key or search text.
Find the correct work item and select its link icon. The tooltip is Link this Work item.
Wait for the success message. Repeat for other work items as needed, then close the dialog.
Each Link or Unlink action saves immediately. You do not need to select the Folder properties Save button to save those relationships. That button is used for separate edits to the folder’s details.
Review the saved links
Reopen Requirements - Work Items → Link / Unlink Work Items.
Clear the search text to return to the linked work item list.
Check the expected keys and summaries. Select a key to open the work item in Jira.
Use the dialog’s work item navigation control, when shown, to open the linked items in Jira search.
The saved link count can differ from the visible list if a linked work item is no longer accessible or cannot be returned by Jira. Check your Jira access before assuming a relationship has been removed.
Unlink a work item
Open the folder’s Link / Unlink Work Items dialog.
Find the linked work item.
Select its unlink icon, with tooltip Unlink this Work item.
Wait for the success message, then confirm the item is no longer in the linked list.
Unlinking removes the relationship to this Test Folder. It does not delete the Jira work item, the folder, or its Test Cases. Other links remain separate.
Understand the different links
Relationship | What it represents |
Work item linked to a Test Folder | A requirement or other Jira work item associated with the folder. |
Work item linked to a Test Case | Traceability between that work item and the individual Test Case. |
Work item linked to a Test Run log | An item, such as a bug, recorded with a particular execution log. |
Linking a requirement to a folder does not automatically link every Test Case in that folder directly to the requirement. Choose the relationship that matches what you want to trace.
If a link is missing or cannot be saved
Confirm that you opened the correct Test Folder and selected the intended Jira space in the search dialog.
Check that the work item exists and that you can view it in Jira.
Check your Vansah permission to edit the folder.
Clear the search to review saved links, or reopen the dialog after an error.
If the visible count and list differ, check work item access and refresh before repeating a link action.