# Tags

{% hint style="info" %}
**Who can use this feature?**

Task Owners, Assignees and Admin users can add Tags to Tasks.

***

All Project Users can create and edit Tags by default. This can be changed to Admins only in the Project Settings.
{% endhint %}

Tags give you a way to label Tasks with anything that matters to your team, from safety and risk, to key priorities, review flags, or anything else. They’re multi-select, fully custom, and can be used to filter views to suit different meetings, roles, or priorities.

## Creating Tags

***

Creating tags lets you build a reusable library of Tags to assign to Tasks.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fg2ITMP1X6z56oVxIbfPw%2FCreate-%20Tags.svg?alt=media&#x26;token=168455aa-062c-43d0-a0f5-b46348192b93" alt=""><figcaption></figcaption></figure>

**To create a new Tag:**

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Tags` from the menu
* Click  <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F2iVsdY2S2eHpsX3vgYRE%2FText%20Buttons%20(2).svg?alt=media&#x26;token=63da6419-6d4b-4263-85a2-7679b87f5044" alt="" data-size="line">&#x20;
* Create your custom Tag by entering the name and assign a colour
* The Tag is added to the library of Tag the team can assign to their Tasks

## Assigning Tags to Tasks&#x20;

***

Tags can be added to Tasks to help group and organise work across your plan, they’re a flexible way to highlight key information without changing the structure.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FxiseE5OKtYOscX6jgw1p%2FGantt-%20Tags%20(1).svg?alt=media&#x26;token=ea7a20f3-62a2-46d6-98d4-975326db8a2a" alt=""><figcaption></figcaption></figure>

**To assign Tags to Tasks:**

* On the Gantt, open the column picker <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FS5zLHPjnK2LdNu2vxUfD%2FIcon%20Buttons.svg?alt=media&#x26;token=857cdfde-d860-4f37-9a41-73f55a5b9733" alt="" data-size="line"> and toggle <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Tags`
* Click a cell in the column to add a Tag to the Task from the dropdown

See also: <a href="../tasks#editing-tasks" class="button secondary">Bulk Edits</a>&#x20;

<details>

<summary>How Tags Work</summary>

* Tags are a multi-select property
* Archived Tags will no longer be available to add to tasks but will still exist on tasks it was assigned to before the resource was archived

</details>

## Filter by Tag

***

Filtering by Tags lets you focus on specific Tasks based on what’s been added to them. It’s a quick way to review and manage work related to a particular Tag across your plan.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FJi3QmOkp0ZYhOrNm0XEr%2FFiltered%20by%20Tag.svg?alt=media&#x26;token=8f90c988-370b-4891-93cd-c251d00ea7ba" alt=""><figcaption></figcaption></figure>

#### To Filter by Tag:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FOmPqOYCGf97WdhYo8fNX%2FView%20Sub%20Nav%20Buttons%20(5).svg?alt=media&#x26;token=bf972626-ce6c-41fe-892c-b49f31e792b1" alt="" data-size="line"> then <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FoccEaETbnXCWjDrIexSy%2FText%20Buttons%20(1).svg?alt=media&#x26;token=16bb6c15-0882-48f9-983f-92f73daeeae7" alt="" data-size="line">
* Select `Tag` in the first dropdown
* Select from `Is`, `Is Not`, `Is Empty` or `Is Not Empty` in the second dropdown
* Select your desired Tag in the third dropdown

See also: create & share <a href="view-controls" class="button secondary">Views</a>&#x20;

<details>

<summary>Filter Breakdown </summary>

| Filter | Operator                                           | Value                          |
| ------ | -------------------------------------------------- | ------------------------------ |
| Tag    | <p>Is <br>Is Not <br>Is Empty <br>Is Not Empty</p> | <p>Multi-Select</p><p><br></p> |

</details>


---

# 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.aphex.co/docs/planner/features/tags.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.
