---
title: "bird labels list"
description: "List labels"
canonical: "https://bird.com/docs/cli/reference/labels-list"
---

# `bird labels list`

## Usage

```bash
bird labels list [flags]
```

## Description

List every label in the workspace's label catalogue, ordered by name, with its colour and its description of when to apply it. Read the descriptions before labelling a conversation and prefer an existing label over creating a new one. A workspace creates no new label once it has 100 or more. Mailbox system labels (inbox, archive, spam, blocked, sent, trash, unread) are a fixed set that every mailbox has, and are not in this list.

## Examples

```bash
bird labels list
```

## Options

| Name                | Description                                      |
| ------------------- | ------------------------------------------------ |
| `--response-schema` | Print the fields this command returns, then exit |

## Related

| Name                                                      | Description    |
| --------------------------------------------------------- | -------------- |
| [`bird labels create`](/docs/cli/reference/labels-create) | Create a label |
| [`bird labels delete`](/docs/cli/reference/labels-delete) | Delete a label |
| [`bird labels get`](/docs/cli/reference/labels-get)       | Get a label    |
| [`bird labels update`](/docs/cli/reference/labels-update) | Update a label |

## Related resources

- [What is omnichannel vs multichannel messaging?](/explained/engagement/what-is-omnichannel-vs-multichannel) (answer)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=omnichannel)
