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

# Labels

> Tools for organizing reviews with labels.

Labels help you categorize and organize your reviews. Create labels, assign them to reviews, and use them to filter your content. Labels can also be applied in bulk using the `batch_update_reviews` tool from the [Reviews](/mcp/tools/reviews) module.

## Available Tools

| Tool              | Description                                                                   | Try asking                                     |
| ----------------- | ----------------------------------------------------------------------------- | ---------------------------------------------- |
| `list_labels`     | List all review labels in your workspace, optionally with their review counts | "Show me all my review labels"                 |
| `create_label`    | Create a new label with a name and optional color (defaults to orange)        | "Create a red 'Featured' label"                |
| `update_label`    | Rename a label or change its colour                                           | "Rename the 'Featured' label to 'Homepage'"    |
| `assign_labels`   | Add one or more labels to a review                                            | "Add the 'Featured' label to this review"      |
| `unassign_labels` | Remove one or more labels from a review                                       | "Remove the 'Featured' label from this review" |

<Note>
  `list_labels` always returns `reviews_count` for each label, alongside its `id`, `name`, and `attributes.css_color_code`. There is no `include` parameter, and the only argument it takes is `workspaceId`.
</Note>

## Identifying Reviews and Labels

Assigning or unassigning labels needs two different kinds of identifier:

* **The review** is identified by `reviewId` (a **number**) plus `feedType` (`text`, `audio`, `video`, or `social`). The id alone is not unique across review types.
* **The labels** are passed as `reviewLabels`, an array of 26-character ULID strings (the `id` field returned by `list_labels`), not label names.

<Note>
  `assign_labels` and `unassign_labels` take `feedType`, while the review tools take `reviewType`. Both accept the same four values. `batch_update_reviews` uses `reviewType` and is usually the better choice for tagging several reviews at once.
</Note>

## Label Colours

`create_label` and `update_label` take a hex colour. The web app's palette is:

| Colour  | Hex       | Colour  | Hex       |
| ------- | --------- | ------- | --------- |
| Orange  | `#EA580C` | Blue    | `#2563EB` |
| Yellow  | `#CA8A04` | Violet  | `#7C3AED` |
| Lime    | `#65A30D` | Fuchsia | `#C026D3` |
| Emerald | `#059669` | Pink    | `#DB2777` |
| Cyan    | `#0891B2` |         |           |

Any hex value is accepted, so existing labels may use colours outside this list. `list_labels` returns each label's colour as `attributes.css_color_code`.