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

# Organize your videos with tags

> Create workspace or private tags, add them to videos, and filter your library by tag.

Tags help you organize your library without moving videos around. Create shared **workspace tags** for your whole team or **private tags** just for yourself, add them to any video, and filter **My videos** by tag.

## Workspace tags vs. private tags

* **Workspace tags** are shared with everyone in the workspace. Anyone can add or remove them on videos they can edit.
* **Private tags** are only visible to you. Adding a private tag only affects your own library — teammates won't see it.

Each tag has a name, a color, and an optional description.

## Create a tag

1. In your library, open a video's **⋯** menu, hover over **Tags**, and click **Manage tags** — or open the **Tags** filter on **My videos** and click the **Manage tags** button.

2. Type a name for the new tag.

3. Choose whether to create it as a **workspace** or **private** tag.

New tags get a color automatically. From the same tag manager you can rename a tag, change its color, add a description, share a private tag with the workspace, or delete it. Deleting a tag removes it from every video it was on.

<Note>
  Private tags can only be renamed or deleted by the person who created them.
</Note>

## Add a tag to a video

1. In your library, open the video's **⋯** menu.

2. Hover over **Tags**.

3. Check the tags you want to apply — or click **Manage tags** to create a new one.

Tags appear on the video's thumbnail and as badge chips on video cards. By default the chips fade in on hover — to keep them always visible, turn on **Always show playlists and tags** from the **⋯** overflow menu next to the grid/list toggle, or in **Settings → Preferences → Library**. Tags also show up inside playlists that include the video.

## Remove a tag

Open the video's **⋯** menu, hover over **Tags**, and uncheck the tag. Removing a tag from a video doesn't delete the tag itself.

## Filter your library by tag

On **My videos**, open the tag filter and pick one or more tags. Videos need to have **every** selected tag to appear in the results, so combining tags narrows the list.

<Tip>
  Combine tag filters with the [sort and view options](/help/tips/sort-filter-and-view-videos) or with [bulk select](/help/account/bulk-select-videos) to act on a whole group of tagged videos at once.
</Tip>

## Tags in the API and MCP

You can list, create, update, and delete tags — and add or remove them from videos — through the public API and MCP server. See the [MCP reference](/mcp-server) for the full list of tag tools.