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

# Labels

> Organize and segment contacts into groups for campaigns, automation, and targeting.

## What is this?

**Labels** help you organize contacts into meaningful groups. Use them to target campaigns, segment customers, trigger workflows, and filter your Inbox and Contacts lists.

![Full Labels page](https://mintcdn.com/wabis/b8QJIW0SgwumJWX0/images/labels-overview.png?fit=max\&auto=format\&n=b8QJIW0SgwumJWX0\&q=85\&s=d0067552ece0830e2eb6f891030529b5)

> [!NOTE]
>
> Labels require the `labels:view` permission and a channel. The number of labels you can create depends on your plan and is shown on the **Create Label** button.

## What can I do here?

* See summary tiles: **Total labels**, **Contacts in labels**, and **Unlabeled contacts**
* Search labels by name
* Create, **Edit**, and **Delete** labels, or **Delete Selected** in bulk
* Track how many contacts belong to each label
* Use labels for campaign targeting, customer segmentation, workflow automation, and grouping by behavior or category

### Label library

| Column | What it shows |
| - | - |
| **Label** | The name that identifies the segment |
| **Description** | Optional details about the label |
| **Contacts** | How many contacts have the label |
| **Created** | When the label was created |
| **Actions** | **Edit** or **Delete** |

## How to use it

### Create a label

1. Go to **Contacts → Labels** and click **Create Label**.
2. Enter a **Label Name** (required) and an optional description.
3. Optionally pick a **Color** — a swatch for the label, or **No color**. The color is used for the label's chip in Contacts, the Inbox and campaigns. Labels without a color keep an automatic color based on their name.
4. Click **Create**. Use **Cancel** to close without saving.

![The Create Label dialog with the Label Name and Description fields](https://mintcdn.com/wabis/b8QJIW0SgwumJWX0/images/labels-create-dialog.png?fit=max\&auto=format\&n=b8QJIW0SgwumJWX0\&q=85\&s=99d5ae5213c0c6397af08cbf9ceeb21b)

### Recommended workflow

1. Create labels based on your use case.
2. Assign labels to contacts — from [Contacts](https://wabis.mintlify.site/workspace/contacts/overview.md), the [Inbox](https://wabis.mintlify.site/workspace/inbox/overview.md) conversation header, or an [automation](https://wabis.mintlify.site/workspace/automation/overview.md).
3. Use labels in filters, campaigns, and automations.
4. Review and clean up unused labels regularly.

> [!TIP]
>
> Keep label names simple and consistent, avoid duplicates, and use labels for segmentation rather than temporary tagging.

## Troubleshooting / Technical Notes

* **"Label name is required."** Enter a name before saving.
* **"Please select or create a WhatsApp channel first."** Labels belong to a channel — connect one in [Channels](https://wabis.mintlify.site/workspace/channels/overview.md).
* **"Upgrade your plan."** You've reached your plan's label limit.
* **Deleting a label.** Before you confirm, the dialog checks where the label is used — contacts, automations, campaigns, events, booking services campaigns, Google Contacts sync and AI agents — and says it will be removed from them. Contacts keep existing but lose the label, and automation steps or AI agent actions that used it will no longer add or remove it, so check them afterwards. Deleted labels go to [Trash](https://wabis.mintlify.site/workspace/trash.md) for 7 days.

## Related docs

* [Contacts](https://wabis.mintlify.site/workspace/contacts/overview.md)
* [Campaigns](https://wabis.mintlify.site/workspace/whatsapp/campaigns.md)
* [Automation Overview](https://wabis.mintlify.site/workspace/automation/overview.md)
* [Inbox](https://wabis.mintlify.site/workspace/inbox/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.