> ## 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](https://docs.messagedesk.com/inbox/labels.md). This page covers **managing the label library** from Settings.

***

## 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.

***

## 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.

***

## 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:`).

***

## Who can manage labels

Your role controls access to label management:

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

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

***

## Import and export labels

You can move labels in and out of MessageDesk in bulk from [Data & Integrations](https://docs.messagedesk.com/settings/workspace-settings/data-center.md).

* **Import labels.** Upload a CSV of labels and map columns for name, color, and icon. The importer updates any label that matches an existing label by **name** with the imported color and icon. See [Import labels](https://docs.messagedesk.com/settings/workspace-settings/data-center.md#import-labels).
* **Export labels.** Run a label export from Data & Integrations to get a CSV of every label in the workspace.

When an import or export finishes, MessageDesk sends a **completed email** to the user who started it.

***

## See also

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


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