Skip to main content

How to Use Custom Labels

Written by Ines

Overview

Custom Labels in Thunders allow you to categorize and organize your Test Cases using color-coded tags. Labels are project-scoped, meaning each project has its own set of labels. You can assign labels to Test Cases, filter by labels in both the Test Cases and Test Runs lists, and manage your labels from a dedicated Label Management page.

Accessing the Label Management Page

The Label Management page is where you create, edit, archive, and delete labels for a project.

  • Navigate to your project

  • Click on Labels in the left sidebar menu

  • The Label Management page displays all labels in the project, including their name, color, description, and status

Creating a Label

You can create a new label in two ways:

Option 1: From the Label Management Page

  • Open the Label Management page from the project sidebar

  • Click the "Create Label" button

  • Enter the following details:

    • Name — A unique name for the label (required). Label names must be unique within the project and cannot use reserved names

    • Color — Choose a color for the label. This color will be used to display the label as a colored pill across the application

    • Description — An optional description to explain the label's purpose

  • Click the check icon in the last column to save the new label.

Option 2: From the Test Cases list

You can create a label directly from the Labels column in the Test Cases list, or from the Labels section in the Test Case’s properties panel:

  • Click the + button

  • Type the label name

  • Click "Create Label"

  • Select a color

The label is created and immediately assigned to the Test Case

Editing a Label

To modify an existing label:

  • Navigate to the Label Management page

  • Locate the label you want to edit in the grid

  • Double-click the name, color, or description field to edit it

  • Press Enter to save your changes

Archiving a Label

Archiving a label removes it from the list of available labels that can be assigned to Test Cases, while preserving it on any Test Cases that already have it assigned.

  • Navigate to the Label Management page

  • Click the action menu (three dots icon) next to the label

  • Click "Archive"

  • Confirm the action when prompted

Deleting a Label

To permanently delete a label:

  • Navigate to the Label Management page

  • Click the action menu (three dots icon) next to the label

  • Click "Delete"

  • Confirm the deletion when prompted

  • Deleting a label removes it from every Test Case where it is currently assigned

Assigning or Removing Labels from Test Cases

You can manage labels for a Test Case using the Label Picker:

  • Click on any existing label on the Test Case or click the + button to add a new label.

  • Once the picker is open:

    • Select a label to assign it to the Test Case

    • Deselect a label to remove it

Filtering Test Cases by Labels

Labels make it easy to find specific Test Cases in your project:

  • Navigate to the Test Cases list

  • Use the Labels filter in the filter bar

  • Select one or more labels to filter by

  • The list will update to show only Test Cases with the selected labels

  • You can also filter by "No Labels" to find Test Cases that have not been labeled yet

Filtering Test Runs by Labels

You can also filter Test Runs by the labels assigned to their associated Test Cases:

  • Navigate to the Runs tab in your project

  • Use the Labels filter to select a label

  • The list will update to show only Test Runs associated with Test Cases that have the selected label

Tips for Using Custom Labels

  • Use consistent naming conventions across your project (e.g., Regression, Smoke Test, Critical)

  • Leverage colors to create a visual hierarchy — for example, use red for critical tests and green for smoke tests

  • Archive labels that are no longer needed instead of deleting them, to preserve historical context

  • Periodically review your labels to ensure they remain relevant and useful

  • Combine labels with Test Sets for even more powerful test organization

Related articles on this topic that you might find helpful :

Did this answer your question?