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

# Tags

> Put your own labels on tasks, files, machines, tools, treatments, and experiments, then find and select records by tag in every list.

**Tags** are project-scoped labels (such as `needs-review` or `release-11`) that help you group and filter records—for example, selecting all tasks for a release in one click. Tags never affect how an experiment executes and stay hidden from [public experiment links](https://docs.oqoqo.ai/evaluation/share.md).

Each tag keeps a stable `tag_` ID even if you rename it. Tag matching is case-insensitive (`Flaky` and `flaky` refer to the same tag).

## What can have tags

| Record type | Dashboard location |
| - | - |
| **Tasks** | **Manage → Tasks** |
| **Files** and **Machines (Environments)** | **Manage → Files**, **Manage → Machines (Environments)** |
| **Skills**, **MCP servers**, **CLIs**, and **SDKs** | **Manage → Tools** |
| **Treatments (Toolsets)** | **Manage → Treatments (Toolsets)** |
| **Experiments** | **All experiments** |

Agents, runs, frictions, and projects do not use tags. Tags belong to the record itself rather than a specific version, so saving a new task or tool version keeps its tags.

## Add and remove tags

> [tab] Dashboard
>
> Open any record, select **Add tag** (or select existing tags) under its name, and pick or create a tag. Changes save immediately.

> [tab] CLI
>
> ```bash theme={null}
> oqoqo tags add needs-review regression --to tsk_3a91c7e2,exp_8f2c41d0
> oqoqo tags remove regression --from tsk_3a91c7e2
> ```
>
> Missing tag names are created automatically, and repeated commands are idempotent ([`oqoqo tags add`](https://docs.oqoqo.ai/cli/tags#oqoqo-tags-add)).

> [tab] Plugin (MCP)
>
> Ask your AI assistant to tag records; it calls **Add or remove tags on records** ([`update_tags`](https://docs.oqoqo.ai/mcp-server/tags-and-data#update_tags)).
>
> ```text theme={null}
> Tag every checkout task in this Oqoqo project with release-11.
> ```

To bulk-tag up to 100 records in the dashboard, check their rows in any list and select **Tag** in the selection bar.

## Find records by tag

Every tagged list and the **New experiment** task picker include a **Tags** filter once your project has at least one tag. Filter by one or more tags, **No tags**, or both together—the active filter stays in the URL so you can bookmark or share it with teammates.

![A list with tag chips on each row and the Tags filter open, showing project tags and No tags.](https://mintcdn.com/oqoqo/YO1ysyUx4SPwBwoz/images/screenshots/tags-filter-light.png?fit=max\&auto=format\&n=YO1ysyUx4SPwBwoz\&q=85\&s=b1a14489320b7c9f9f3b2200fbd72e57)

## Rename or delete a tag

Open the tag picker on any record (or **Tag** in a bulk selection), hover over a tag and select the edit icon, then enter a new **Name** and **Save changes**—or select **Delete tag**. Renaming updates every tagged record across the project.

> [!WARNING]
>
> Deleting a tag permanently removes it from the project and unlinks it from all records (the records themselves stay intact).

## Names and limits

| Rule | Limit |
| - | - |
| Tag name | 1 to 40 characters (leading/trailing spaces trimmed, repeated spaces collapsed, no commas, control characters, or `tag_` prefix) |
| Tags per record or per filter/update | 20 |
| Tags per project | 500 |
| Records per bulk tag change | 100 |

## From the CLI and the plugin

The CLI and plugin accept either a tag's name (case-insensitive) or its `tag_` ID.

| Task | CLI | Plugin (MCP) |
| - | - | - |
| List project tags | [`oqoqo tags list`](https://docs.oqoqo.ai/cli/tags#oqoqo-tags-list) | [`list_tags`](https://docs.oqoqo.ai/mcp-server/tags-and-data#list_tags) |
| Add or remove tags | [`oqoqo tags add`](https://docs.oqoqo.ai/cli/tags#oqoqo-tags-add), [`remove`](https://docs.oqoqo.ai/cli/tags#oqoqo-tags-remove) | [`update_tags`](https://docs.oqoqo.ai/mcp-server/tags-and-data#update_tags) |
| Rename a tag | [`oqoqo tags rename`](https://docs.oqoqo.ai/cli/tags#oqoqo-tags-rename) | [`rename_tag`](https://docs.oqoqo.ai/mcp-server/tags-and-data#rename_tag) |
| Delete a tag | [`oqoqo tags delete`](https://docs.oqoqo.ai/cli/tags#oqoqo-tags-delete) | [`delete_tag`](https://docs.oqoqo.ai/mcp-server/tags-and-data#delete_tag) |
| Filter resources or experiments by tag | [`oqoqo catalog list --tag`](https://docs.oqoqo.ai/cli/catalog#oqoqo-catalog-list), [`experiments list --tag`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-list) | [`inspect_catalog`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#inspect_catalog), [`list_experiments`](https://docs.oqoqo.ai/mcp-server/experiments#list_experiments) |

## Next steps

> [card] [Launch an experiment](https://docs.oqoqo.ai/experiments/launch.md)
>
> Filter tasks by tag when launching an experiment.

> [card] [oqoqo tags](https://docs.oqoqo.ai/cli/tags.md)
>
> Full reference for all `oqoqo tags` commands.


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