# 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

You can manage tags in the following two locations:

* **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.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e6d3ff21ca114f10929768124851381adb492ad8%2Fproduct-documentation_dashboards_dashboards-lables-1.png?alt=media\&token=afae7cd4-cdc6-42bb-8af6-df567f510a59)

The **Manage** link beside **Custom Tags** is used to manage dashboard tags. You can also manage all tags at **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.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-851f79f0aed1586c253d80e54ca2def247e8b4c7%2Fproduct-documentation_dashboards_dashboards-lables-2.png?alt=media\&token=7b0c0d54-8d8f-4a90-ac00-d99d271644e9)

The **Manage Tags** link beside the **Tags** dropdown is used to manage dashboard tags.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-3350859420b3add8f72b09e0354aab7e5560dd49%2Fproduct-documentation_dashboards_dashboards-lables-3.png?alt=media\&token=667eef9d-8f00-4882-bc19-c0e04698cc85)

To manage dashboard tags:

1. Click the **Manage** link or **Manage Tags** link located in the dashboard selector and edit dashboard sections respectively.
2. Both links open the side panel for managing dashboard tags (or navigate to **Manage > Tags** for the full Tags workspace).

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-1cae79b03a4a18c3ba5fddb9336ecba038eb7e79%2Fproduct-documentation_dashboards_dashboards-lables-4.png?alt=media\&token=1f023500-d564-4904-8ea9-516d61f7604d)

3. The panel displays a table of all existing dashboard tags along with a Search field and filter options to search the list.

### Create a New Tag

To create a new tag:

1. Navigate to the dashboard tags management panel or **Manage > Tags**.
2. Click the **New Tag** or **Add tag** button.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-9a2c1bba1794ced2a368471b453057b8fa5d4f5b%2Fproduct-documentation_dashboards_dashboards-lables-5.png?alt=media\&token=fc745585-4832-4c29-9133-2d15ba68a62b)

3. Enter the **Key** and **Value** (or **Name**), select the **Color**, and assign the associated dashboards from the **Dashboards** dropdown.
4. Click **Add** or **Save** to confirm the creation of the tag.

### Add Dashboard to a Tag

To add a dashboard to a tag:

1. Navigate to the dashboard tags management panel or **Manage > Tags**.
2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.
3. Click on the ellipsis icon and select **Edit** option.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-df604768feb1f477c0a60cdd1b2d4c2ac98b33c6%2Fproduct-documentation_dashboards_dashboards-lables-6.png?alt=media\&token=dbb8b31f-3336-4883-bc71-17cfd5f92e3a)

4. You can select the desired dashboards to add them to this tag.
5. Click **Save** to confirm the changes.

Alternatively, you can also add the dashboard to a tag using the **Edit Dashboard** option in the **Options** button or ellipsis icon.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e2929a56fb7abc8aef79cdc4ca473b1e7dd8ff8f%2Fproduct-documentation_dashboards_dashboards-lables-7.png?alt=media\&token=6149eafc-27fd-4cbc-8766-600fa763651b)

Select the tags from the **Tags** dropdown that you intend this dashboard to be associated with.

### Edit an Existing Tag

To edit an existing tag:

1. Navigate to the dashboard tags management panel or **Manage > Tags**.
2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.
3. Click on the ellipsis icon and select **Edit** option.
4. You can edit the key, value, color, and dashboards assigned to the tag.
5. Click **Save** to confirm the changes.

### Delete a Tag

To delete an existing tag:

1. Navigate to the dashboard tags management panel or **Manage > Tags**.
2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.
3. Click on the ellipsis icon and select **Delete** option.
4. Click **Delete** to confirm the deletion.

### Duplicate an Existing Tag

To duplicate an existing tag:

1. Navigate to the dashboard tags management panel or **Manage > Tags**.
2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.
3. Click on the ellipsis icon and select **Duplicate** option.
4. Enter the **Name** or **Key/Value** for the duplicate tag. The rest of the fields are populated based on the original tag. However, you can edit them accordingly.
5. Click **Save** to confirm the creation of the duplicate tag.


---

# 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://docs.thousandeyes.com/product-documentation/dashboards/dashboard-labels.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.