> For the complete documentation index, see [llms.txt](https://help.pesipiuma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pesipiuma.app/en/workspace-management/tags-and-user-groups.md).

# Tags

## What are tags for?

Tags help search, organize, and filter projects in a workspace.

Use tags for business categories such as:

* Brand.
* Line.
* Season.
* Collection.
* Customer.
* Development stage.

Tags appear in the dashboard sidebar as filters and on project cards as assigned labels. Each tag has a type: **General**, **Brand**, or **User group**. Tags with the same type use the same system-defined color, and tag lists are grouped by type with names sorted alphabetically.

## Add a new tag

1. Open the user menu.
2. Select **Tags** from the workspace settings section.
3. Click **New Tag**.
4. Enter the tag name.
5. Choose the tag type.
6. Click **Create Tag**.

## Edit or delete a tag

1. Open **Tags** from the workspace settings section.
2. Use search if needed to find the tag.
3. Click **Edit** to update its name or type.
4. Click **Delete** to remove it from the workspace.

{% hint style="warning" %}
Deleting a tag removes it from every project where it is assigned.
{% endhint %}

## Filter projects by tag

In the dashboard sidebar, click a tag to filter the project list. Click it again to remove the filter, or clear the active filters from the tag filter area.

{% hint style="info" %}
Users with write access can manage workspace tags. Viewers can see project tags but cannot create, edit, delete, or assign them.
{% endhint %}