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

# Labels

> Manage your workspace's label library in MessageDesk. Create, edit, and delete shared labels (name, color, icon) that everyone on your team can apply to conversations.

# Labels

The **Labels** settings page is where you manage the **shared label library** for your workspace. It's the catalog of labels that everyone on your team can apply to conversations.

<Note>
  Looking for how to **apply** labels inside a conversation, build label-based filters, or rename labels from the inbox? See [Inbox → Labels](/inbox/labels). This page covers **managing the label library** from Settings.
</Note>

***

## Open the Labels page

Go to **Account → Settings → Workspace Settings → Labels**.

***

## Create a new label

1. Click **Create label**.
2. Set the label's properties:
   * **Name:** short and scannable (e.g., `Support: Urgent`, `Region: West`).
   * **Color:** pick a color to help teammates spot it at a glance.
   * **Icon:** choose an icon that fits the label's purpose.
3. Click **Save**.

The label becomes available everywhere labels are used: conversation label menus, filters, and views.

<Tip>
  Use short prefixes like `HR:`, `Sales:`, or `Support:` to group related labels. Labels sort alphabetically, so prefixes are an easy way to control where they appear in lists.
</Tip>

***

## Edit a label

1. Find the label in the list (or search by name).
2. Click the label to open its editor.
3. Update the **name**, **color**, or **icon**.
4. Click **Save**.

<Warning>
  Renaming a label updates it **everywhere** it's already applied. Existing conversations keep the relationship to the label. Only the displayed name, color, or icon changes.
</Warning>

***

## Delete labels

You can delete a single label or multi-select to delete several at once.

**Single label:**

1. Find the label in the list.
2. Click the **delete** icon.
3. Confirm.

**Bulk delete:**

1. Multi-select the labels you want to remove.
2. Click **Delete selected**.
3. Confirm.

Deleting a label removes it from every conversation it was applied to.

***

## Label sort order

<Note>
  Labels sort **alphabetically (A–Z)** by name across label menus, settings, and filters. To control where a label appears, rename it with a prefix (`HR:`, `Support:`).
</Note>

***

## Who can manage labels

Your role controls access to label management:

| Role         | Labels access                 |
| ------------ | ----------------------------- |
| **Admin**    | Owner (create, edit, delete)  |
| **Manager**  | Editor (create, edit, delete) |
| **Operator** | Editor (create, edit, delete) |

See [Roles and Permissions](/settings/workspace-settings/team-management) for the full default permissions table and how to customize roles.

***

## See also

* [Inbox → Labels](/inbox/labels): apply labels to conversations and filter by label
* [Team Management and Permissions](/settings/workspace-settings/team-management)
