---
title: "Labels"
slug: "labels"
updated: 2026-05-13T09:24:03Z
published: 2026-05-13T09:24:03Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchpoint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Labels

## Overview

Labels allow you to group your tests by self-defined criteria for easier sorting and location. Labels are structured as `name : value` pairs and allow you to tag individual tests with one or more labels.

This article explains how to use the Labels feature in the Catchpoint application. For information on how to leverage Labels in our APIs, consult our **REST API Help** page which is accessible from the Help menu in the upper-right hand corner of the Catchpoint portal.

## Procedure

Add your label in the **Label** field that is available in Test Properties. ![label.png](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/360094398512-label.png) *Note: the Label field is only available at the individual test level, and not for Products or Folders.*

Each label is a name-value pair separated with a colon `:` which allows users to categorize them. Example: `Production : New York`

In the above example, `Production` is the name which can be treated as a Category, and `New York` is a value in the "Production" category. Categories/Names are unique; you can have the same value across categories. An example of this would be using both `Production : New York` and `QA : New York` A unique color is automatically assigned to each new label Name. These colors then remain the same for all the `Name : Value` pairs; allowing for easier identification.

**Labels are case-insensitive** i.e. if you create a new label **`Environment`** and later create another label as **`envirONment`**; both of these are treated as the same.

`Name : Value` pairs can only contain letters, numeric characters, underscores, and dashes. International characters are allowed. Labels should **NOT** contain the following characters: `<, >, %, &, \, ?, /`

## Usage

Labels are used for filtering and/or narrowing down a list of tests. A new option is now available in:

- The search area of the Control Center
- the Test selector in the Analysis module where you can search by Label Name or Label Value.
- Use the format as **/label: Label Name or Label Value** to search for any test with the specific label.  

![Label.png](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/9691246697755-Label.png)

Note:

- Each label name and value must not exceed 128 characters.
- You can assign up to 100 labels to a single test.