Use labels to group related test cases and find them with filters. A test case can have several labels, so you can organize it by feature, test purpose, or release without moving it to another folder.
Label example | Use it to group |
| Test cases for a feature. |
| Test cases you rerun to check existing behavior. |
| Test cases for a release. |
Before you begin
Labels must be enabled for your Jira space.
You need permission to edit the test case to save label changes.
Creating a new label in Vansah also requires the Add new Test Case Label permission.
Enable labels for a Jira space
A Jira space administrator or Jira administrator can enable labels.
Open Vansah in your Jira space.
Select the Settings icon, then Settings and Compliance.
Select Space Settings, then Miscellaneous.
Select Enable Labels for Vansah Test Cases. The setting is saved automatically.
For the full navigation steps, see Accessing Vansah Space Settings.
Add labels to a test case
Open Vansah and select Test Cases.
Open the test case and check that you are viewing the version you want to update.
In the test case details, select the Labels field.
Search for an existing label and select it. To add a new label, type its name and select Create.
Repeat to add any other labels, then select Save at the top of the test case.
Label names cannot contain spaces. Use a short, consistent name such as finance-module instead of finance module.
Labels are saved for the test case version you are editing. Check the version if a label appears on one version but not another.
Remove a label from a test case
Open the test case and select the version you want to update.
In Labels, select the × beside the label you want to remove. You can also use the field’s clear control to remove all selected labels.
Select Save.
This removes the label from that test case version. Other test cases using the same label keep it.
Find test cases by label
Open the test case list in the Vansah board, a Jira work item’s Vansah Test Management panel, or a test plan.
Select Filters +. Use More + to add the Label(s) filter if it is not already displayed.
Open the label filter, search for a label, and select it.
The filter searches within the list you have open. For example, filtering a test plan shows matching test cases in that plan. Use Clear filters to return to the unfiltered list.
How Vansah labels relate to Jira labels
The label picker combines available Jira label names with labels already used in Vansah, so you can reuse familiar names.
Assign labels to the test case and save them in Vansah. Adding or removing a label on a linked Jira work item does not automatically add or remove that label on the test case, and changing a test case’s labels does not update the Jira work item’s Labels field.
If you cannot add or find a label
The Labels field is missing: Ask your administrator to enable labels for the Jira space.
You cannot save changes: Check your test case editing permission.
You cannot create a label: Ask your administrator to check Add new Test Case Label. This can also apply when a Jira label is being used in Vansah for the first time.
No test cases match the filter: Check the selected folder, work item, or plan, any other filters, and the labels saved on the relevant test case versions.