Skip to main content

Relink a Test Plan Case to Its Work Item or Folder

Restore a missing requirement link when a case remains in a Test Plan but has been unlinked from the plan’s Jira work item or Test Folder.

A Test Case can remain visible in a Test Plan after it is unlinked from the plan’s underlying Jira work item or Test Folder. Vansah shows an unlinked icon so you can restore that requirement association before continuing execution.

Understand the unlinked icon

Hover over the icon beside the case to see which work item or folder is missing the link. This is the plan’s requirement context, rather than a request to create a duplicate Test Case.

A case with a missing required association can be unavailable for execution. Relinking restores the association; it does not remove a separate block or grant missing permissions.

Unlinked icon beside a Test Case in a Test Plan

Relink the case

  1. Open the correct Test Plan and iteration.

  2. Find the affected case and hover over its unlinked icon. Check that the named work item or folder is the requirement you intend to restore.

  3. Select the unlinked icon.

  4. Review the Relink Test Case confirmation and case key.

  5. Select Relink.

  6. Refresh the plan, confirm the icon is gone, and check the case’s association in the underlying work item or folder.

Relink Test Case confirmation

Check the case version and execution access

Review the case version used by the plan and the active version linked to its work item or folder. If they differ, resolve the version selection before executing the test.

If the icon remains or execution is still unavailable, check the underlying requirement link, case blocking, and your access to the case and Jira space. See Block and Unblock Test Cases for blocking guidance.

If the association was intentionally removed, review the plan’s cases instead of relinking automatically. A link should reflect the requirement coverage your team wants to maintain.

Did this answer your question?