Use labels to group related test cases and find them quickly. For example, add smoke, regression or checkout to describe a test’s purpose or feature. A test case can have more than one label.
Before you begin
You need permission to edit the test case to save label changes.
To create a new label, you also need the Add new Test Case Label permission in Vansah.
If you cannot see the Labels field, ask an administrator to enable labels for the space using the steps below.
Enable labels for your space
An administrator who can manage Vansah settings can enable labels for each space.
Open Vansah and select the settings gear icon.
Choose Settings and Compliance, then Space Settings.
Find the space and select Edit. On the next screen, choose Space Settings to open its configuration.
Select Miscellaneous.
Select Enable Labels for Vansah Test Cases. The setting is saved automatically.
Return to Test Cases and open a test case. The Labels field is available on the Main tab.
Add existing labels to a test case
In Vansah, open Test Cases and select the test case.
On the Main tab, find Labels in the test case details.
Click the field and start typing to search the available labels. Suggestions include labels from Jira and Vansah.
Select the label you want. Repeat to add more labels.
Select Save to keep your changes.
Create a new label
Open the test case and find Labels on the Main tab.
Type the new label name.
Select Create "your-label" when it appears. The label is added to your selection.
Select Save.
Label names cannot contain spaces. Use a hyphen or underscore to separate words, such as checkout-smoke or release_2026_11. Reuse an existing label when it already describes what you need.
Create a new label in the Labels field, then select Save.
Remove labels from a test case
Open the test case and find Labels on the Main tab.
Select the × beside the label you want to remove. Use the field’s clear control to remove all selected labels.
Select Save.
Other test cases keep their labels.
Update labels on several test cases
In Test Cases, select the checkboxes beside the cases you want to update.
Choose Edit properties from the selection toolbar.
Select the Labels checkbox and choose the labels to apply.
Select Update to open the confirmation screen. Choose how to handle existing labels using the option below.
Review the selected cases and labels, then select Update to apply the change.
Reset Labels with values selected | What happens |
Leave unchecked | Add the selected labels while keeping the labels already on each test case. |
Select the checkbox | Replace each selected test case’s existing labels with only the labels you selected. |
To use a new label in a bulk update, create and save it on a test case first so it appears in the label list.
Find test cases by label
Open Test Cases and select Filters.
If Label is not already shown, select More and add the Label filter.
Open Label. Use Search Labels to find a label and select its checkbox. Select more labels if needed.
The test case list updates as you change the selection. Close the filter menu to return to the list.
To remove the label filter, clear its selected checkboxes. Clear filters removes all active filters.
Troubleshooting
What you see | What to check |
The Labels field is missing | Ask an administrator to turn on Enable Labels for Vansah Test Cases for the correct space, then close and reopen the test case. |
You cannot create a new label | Check that the name has no spaces and that you have the Add new Test Case Label permission. |
Your label changes are not saved | Select Save before leaving the test case. Check your edit permission and complete any other required fields. |
The filter cannot load labels | Select Retry if it appears in the Label filter. If the problem continues, refresh Vansah and try again. |
