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

# Labels

> Create and use labels to organise and filter chats, contacts, and tickets across your workspace.

## Overview

Labels help you categorise and manage chats, contacts, and tickets. Apply multiple labels to any item, filter your inbox by label, and use labels to control which chats team members can access.

<iframe src="https://www.youtube.com/embed/_xTVqHt3n_I" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

***

## Creating a Label

Labels are created from your organisation settings.

1. Go to **Settings** from the left sidebar
2. Under the **Organisation** section, click **Labels**
3. Click **Create Chat Label**
4. Enter a **name** and choose a **colour**
5. Click **Save Label**

<Frame>
  <img src="https://mintcdn.com/bharatkumarramesh/t8nm8bYLv_UOmhUL/images/image-23.png?fit=max&auto=format&n=t8nm8bYLv_UOmhUL&q=85&s=377c7ac0dcd2d63a114e77dbec2862ac" alt="Image" width="1920" height="971" data-path="images/image-23.png" />
</Frame>

<Tip>You can also create labels on the fly — type a new label name anywhere labels are applied and click **Create label**.</Tip>

***

## Applying Labels

### To a Chat

Open any chat and click **Add label** in the right-hand panel. You can apply multiple labels to the same chat.

<img className="block dark:hidden border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/nLZLyDfnObVs3JXO/features/images/add-label.png?fit=max&auto=format&n=nLZLyDfnObVs3JXO&q=85&s=2930f944615677ac3655b454fb269108" alt="add-label" width="394" height="531" data-path="features/images/add-label.png" />

### To a Contact

Navigate to **Contacts**, select a contact, and click **Add label** on the right-hand panel.

<img className="block dark:hidden border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/nLZLyDfnObVs3JXO/features/images/add-label-contacts.png?fit=max&auto=format&n=nLZLyDfnObVs3JXO&q=85&s=08d3f2eaec1eae66918a23988d1d321d" alt="add-label-contacts" width="398" height="319" data-path="features/images/add-label-contacts.png" />

### To a Ticket

Navigate to **Tickets**, select a ticket, and click **Add label** on the right-hand panel.

<img className="block dark:hidden border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/nLZLyDfnObVs3JXO/features/images/add-label-tickets.png?fit=max&auto=format&n=nLZLyDfnObVs3JXO&q=85&s=9040a092d9ba2b2bce08d5ec6ad5f85c" alt="add-label-tickets" width="397" height="571" data-path="features/images/add-label-tickets.png" />

***

## Filtering by Label

Once labels are applied, use them to filter your inbox.

1. Go to **Chats**
2. Click the **Filter** icon at the top of the chat list
3. Under **Filter condition**, select **Labels**
4. Choose the label to filter by

<Frame caption="Filtering by label">
  <img src="https://mintcdn.com/bharatkumarramesh/t8nm8bYLv_UOmhUL/images/image-25.png?fit=max&auto=format&n=t8nm8bYLv_UOmhUL&q=85&s=82eee58fd231b8d76761741e80c1e28e" alt="Image" width="1156" height="963" data-path="images/image-25.png" />
</Frame>

Only chats with that label will appear — useful for focusing on a specific group like "VIP" or "Renewal".

***

## Managing Labels

Go to **Settings > Labels** to view, rename, or delete any label. Click on a label to edit it.

<img className="block dark:hidden border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/IzTgyiP5udfKpAu_/features/images/edit-label.png?fit=max&auto=format&n=IzTgyiP5udfKpAu_&q=85&s=116b9aca3ed8b4f95bad038fe691cac1" alt="edit-label" width="766" height="562" data-path="features/images/edit-label.png" />

***

## Using Labels with the Org Assistant

Instead of updating chats one by one, instruct the Org Assistant to act on all chats with a specific label at once.

**Example prompts:**

```text theme={null}
Assign all chats labelled "Demo" to Rahul.
```

```text theme={null}
Send a private note to all chats labelled "Renewal" saying "Follow up before Friday."
```

```text theme={null}
Add the label "Escalated" to all open chats assigned to Priya.
```
