Skip to main content

Labels for Test Cases

Learn how to enable labels, add or remove them from test cases, update several cases and find tests by label in Vansah.

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.

  1. Open Vansah and select the settings gear icon.

  2. Choose Settings and Compliance, then Space Settings.

  3. Find the space and select Edit. On the next screen, choose Space Settings to open its configuration.

  4. Select Miscellaneous.

  5. Select Enable Labels for Vansah Test Cases. The setting is saved automatically.

  6. 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

  1. In Vansah, open Test Cases and select the test case.

  2. On the Main tab, find Labels in the test case details.

  3. Click the field and start typing to search the available labels. Suggestions include labels from Jira and Vansah.

  4. Select the label you want. Repeat to add more labels.

  5. Select Save to keep your changes.

Create a new label

  1. Open the test case and find Labels on the Main tab.

  2. Type the new label name.

  3. Select Create "your-label" when it appears. The label is added to your selection.

  4. 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.

Creating a new label in the test case Labels field, with the Save button visible

Create a new label in the Labels field, then select Save.

Remove labels from a test case

  1. Open the test case and find Labels on the Main tab.

  2. Select the × beside the label you want to remove. Use the field’s clear control to remove all selected labels.

  3. Select Save.

Other test cases keep their labels.

Update labels on several test cases

  1. In Test Cases, select the checkboxes beside the cases you want to update.

  2. Choose Edit properties from the selection toolbar.

  3. Select the Labels checkbox and choose the labels to apply.

  4. Select Update to open the confirmation screen. Choose how to handle existing labels using the option below.

  5. 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

  1. Open Test Cases and select Filters.

  2. If Label is not already shown, select More and add the Label filter.

  3. Open Label. Use Search Labels to find a label and select its checkbox. Select more labels if needed.

  4. 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.

Did this answer your question?