> For the complete documentation index, see [llms.txt](https://docs.thousandeyes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thousandeyes.com/product-documentation/dashboards/dashboard-labels.md).

# Working with dashboard tags

{% hint style="info" %}
The Labels feature has been upgraded to **Tags**. All your existing labels have been automatically migrated to the new tagging system with no action required on your part. Existing labels were converted to a tag key with an empty value (for example, a label named `subnet-10` is now a tag with the key `subnet-10` and no value). You can now manage all tags centrally by navigating to **Manage > Tags**.
{% endhint %}

Tags provide an easy-to-use folder structure that allows you to organize your data visualization efforts in the ThousandEyes platform. Tags make it easier to group applications, multiple locations, or thousands of endpoints.

You can create a tag for a specific context and assign the corresponding dashboards. This way, when you filter the dashboard selection and select a tag, only the associated dashboards are displayed. You can also **Group By** tags, meaning the hierarchy of the dashboard selector will have a tag as its top-level association and every dashboard associated with that tag will fall under that hierarchy.

{% hint style="info" %}
By default, you can group and sort dashboards by tags. To **create, edit, or delete** tags, you need the appropriate permissions. In the API, tag management is controlled by the `SETTINGS_LABELS_UPDATE` permission identifier (it may appear as `SETTINGS_TAGS_UPDATE` if the identifier has been renamed in your environment). For role-based access control (RBAC), the related permission names in ThousandEyes are **Edit tags** and **View tags**, which replace **Edit labels** and **View labels**. For more information, see [Role-Based Access Control, explained](https://docs.thousandeyes.com/product-documentation/user-management/rbac/role-based-access-control-explained) and the [roles and permissions table](https://docs.thousandeyes.com/product-documentation/user-management/rbac/built-in-roles-and-permissions#roles-and-permissions-table).
{% endhint %}

## Manage Dashboard Tags

Dashboard tag management uses the central Tags workspace. The dashboard **Manage** and **Manage Tags** links open **Manage > Tags**, where you can create, edit, duplicate, delete, and assign dashboard tags. For general tag management instructions, see [Work with Key-Value Tags](https://docs.thousandeyes.com/product-documentation/tags/working-with-tags).

* **Dashboard Selector**: This dropdown menu provides a list of existing dashboards, along with a Search field, filter options to search the list, tags, and other grouping options.

![](/files/BgCx0ya0BwpkKtKwpFXM)

The **Manage** link beside **Custom Tags** opens **Manage > Tags**.

* **Edit Dashboard**: This option is located in the **Options** button or ellipsis icon, and provides you with the ability to edit the dashboard details.

![](/files/yjtqmQaBV1BIZqoxDmwu)

The **Manage Tags** link beside the **Tags** dropdown also opens **Manage > Tags**.

![](/files/3oP0gNSofavFfdFvqx5i)

Changing a dashboard tag key or value in **Manage > Tags** changes the tag text shown in the dashboard selector and dashboard grouping. Dashboards assigned to the tag stay assigned to the same tag, but users may need to search for or select the new tag text after the rename.

### Assign a Tag to a Dashboard

You can assign tags to a dashboard from the dashboard settings. Open the dashboard **Options** menu, select **Edit Dashboard**, and select the tags from the **Tags** dropdown.

![](/files/mkEyQgEjkK3uWmIpBITA)