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

# Tags

> Organize flows, agents, knowledge bases and tables with workspace tags

Tags are custom colored labels that group related work. They belong to the workspace, not to a single tool, meaning the same tags are shared across flows, agents, knowledge bases and tables.

<Frame>
  <video autoPlay muted loop playsInline controls preload="auto" width="3840" height="2152" style={{ width: "100%", height: "auto" }}>
    <source src="https://storage.googleapis.com/noxus-docs-videos/tags/tags-overview-v2.mp4" type="video/mp4" />
  </video>
</Frame>

## Creating a tag

<Steps>
  <Step title="Open the Tags menu">
    In the **Workshop**, open any tab and click **Tags** next to the search bar. Then click **Create new tag**.
  </Step>

  <Step title="Name the tag">
    Enter a **Tag name**, for example `Finance`. Names are required, can be up to 36 characters and must be unique in the workspace.
  </Step>

  <Step title="Pick a color">
    Choose a **Color** and click **Save**.
  </Step>
</Steps>

A tag created on one tab is available on every tab straight away.

You can also create a tag while tagging an item: open a row's tag menu (see below) and click **New tag**. The new tag is added to that item straight away.

## Adding and removing tags

The **Tags** column shows up to two tags per item. If an item has more, a `+N` badge appears; hover it to see the rest.

<Steps>
  <Step title="Open the row's tag menu">
    Hover an item in the list and click the **+** icon in its **Tags** column.
  </Step>

  <Step title="Tick or untick tags">
    Tick a tag to add it to the item, or untick it to remove it. Changes are saved immediately.
  </Step>
</Steps>

<Note>
  On tables, tags will only appear on Custom tables. [Platform tables](/platform/tables/platform-tables) can't be tagged.
</Note>

## Filtering by tag

### In the Workshop

Click **Tags** next to the search bar and tick one or more tags. The list shows items that have **any** of the selected tags, and the button changes to show how many tags are filtered, for example **2 tags filtered**.

* The tag filter combines with the search and the other filters on the tab, such as the status on Flows and Agents.
* On the **Tables** tab, switching the table kind to **Platform** clears the tag filter.
* If nothing matches, click **Clear filters** to reset them.

### In Past usage

In **Past usage**, the **Flows** tab has its own **Tags** filter. It shows the runs of flows that have any of the selected tags, and combines with the time range, status and **Started by** filters. The smart runs search also respects it.

## Editing and deleting tags

In the **Tags** menu of any Workshop tab, hover a tag and click its **⋮** menu:

* **Edit**: change the tag's name or color. The change applies everywhere the tag is used.
* **Delete**: removes the tag from the workspace and from every flow, agent, knowledge base and table that had it. The items themselves are not affected.

<Warning>
  Deleting a tag can't be undone, and it affects every tool in the workspace, not just the tab you deleted it from.
</Warning>

## Permissions

| Action | Permission needed |
| :- | :- |
| See tags and filter by them | Read access to the workspace |
| Create, edit, add or remove tags | Edit access to the workspace |
| Delete a tag | Delete access to the workspace |

Without edit access, the **+** icon in the Tags column is hidden.

## Tags in the API

Tables and flows returned by the public API include their tags, for example the `tags` field of [List tables](/api-reference/v1--tables/list-tables). Tags can't be created or assigned through the public API; manage them in the Workshop.


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