# Labels

Labels let you tag recordings and bug reports with custom categories so your team can triage, filter, and find items faster. Each workspace defines its own set of labels, and bug report labels and recording labels are managed separately.

***

### Enabling labels

Labels are disabled by default. An Admin or Editor must turn them on before the team can use them.

{% stepper %}
{% step %}

#### Open the Labels settings

Navigate to **Settings → Labels**. You will see two tabs: **Bug Reports** and **Recordings**.
{% endstep %}

{% step %}

#### Toggle the feature on

Select the tab for the type you want to enable and flip the **Enable labels** toggle, then click **Save**.

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2FyTYSjOcFlywS2SyeAORN%2FCleanShot%202026-02-09%20at%2015.03.26%402x.png?alt=media&#x26;token=d0893915-99f4-4d46-b10e-86bd8904a8d7" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Disabling labels hides the label UI throughout the workspace, but existing label assignments are preserved. Re-enabling the toggle brings everything back.
{% endhint %}

***

### Creating labels

Once labels are enabled, Admins and Editors can create them in two places:

**From Settings** — On the **Settings → Labels** page, click the **+ Label** button next to the existing labels, type a name (up to 50 characters), and press Enter.

**On the fly** — When applying labels to a recording, type a name that doesn't exist yet in the search field and click **Create "\[name]"**. The label is created and applied in one step. This option is only available to Admins and Editors.

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2FJkDiqJyYhEzh46giLePN%2FCleanShot%202026-02-09%20at%2015.04.09%402x.png?alt=media&#x26;token=43d287dc-6543-47ae-91c2-57d3e5345568" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Label names must be unique within each type. You can have a "Bug" label for bug reports and a separate "Bug" label for recordings, but not two "Bug" labels for the same type.
{% endhint %}

***

### Applying labels

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2FyQCwRHjGKRds1OOPJwWj%2FCleanShot%202026-02-09%20at%2015.05.02%402x.png?alt=media&#x26;token=2a096463-26f2-4ff7-aa91-d3942ebac413" alt=""><figcaption></figcaption></figure>

Open any recording or bug report and look for the **Add Label** / **Add labels** button. Click it to open a dropdown with all available labels for that type. Check one or more labels to apply them; uncheck to remove.

The dropdown includes a search field to quickly find labels by name.

| Role       | Can apply / remove labels | Can create / delete labels |
| ---------- | ------------------------- | -------------------------- |
| Owner      | Yes                       | Yes                        |
| Admin      | Yes                       | Yes                        |
| Editor     | Yes                       | Yes                        |
| Member     | Yes (own items only)      | No                         |
| Watch Only | No                        | No                         |

***

### Filtering by labels

Both the **Recordings** list and the **Bug Reports** list include a **Labels** filter.

1. Click the filter bar and choose **Labels**.
2. Select one or more labels from the list.
3. Click **Apply**.

The list updates to show only items that match the selected labels. Active label filters are visible as chips that you can remove individually or clear all at once.

{% hint style="info" %}
**Tip for managers:** Combine the labels filter with other filters (date range, assignee, type) to quickly surface what matters — for example, all "Escalated" recordings from the past week.
{% endhint %}

***

### Deleting labels

On the **Settings → Labels** page, each label shows a usage count (how many items it is applied to). Click the **×** button next to a label to delete it. You will be asked to confirm — deleting a label removes it from all associated recordings or bug reports.

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2FZXOJJwI3grZPOPOwti2A%2FCleanShot%202026-02-09%20at%2015.06.01%402x.png?alt=media&#x26;token=e2b9fb26-4f1c-494d-aa48-901b5b54286c" alt=""><figcaption></figcaption></figure>

***

### Good to know

* Bug report labels and recording labels are **completely separate**. Creating a label under the Bug Reports tab does not make it available for recordings, and vice versa.
* All label creation, updates, and deletions are recorded in the audit log when audit logs are enabled for your workspace.
* Labels are available on all plans.