# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.pesipiuma.app/en/workspace-management/tags-and-user-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.