# Get Started with Tags

ThousandEyes uses a flexible, key-value tagging infrastructure to help you organize, filter, and manage your platform assets. Tags replace the legacy labels system, providing dynamic, contextual metadata that spans across tests, agents, dashboards, and alerts.

By using tags, you can:

* **Improve resource organization:** Group assets logically using key-value pairs (for example, `Environment: Production` or `Location: EMEA`).
* **Streamline integrations:** Standardize metadata to easily correlate ThousandEyes data with third-party IT service management (ITSM) and application performance monitoring (APM) tools like ServiceNow and AppDynamics.
* **Enhance analytics:** Use tags to filter dashboard widgets, group data, and create targeted alert rules.

## The Tags Workspace

To access the centralized tagging interface, navigate to **Manage > Tags**. From this screen, you can view, create, edit, duplicate, delete, and manage assigned items for tags across all product areas (such as Cloud & Enterprise Agents, Endpoint Agents, and Internet Insights).

The Tags list displays:

![Manage > Tags workspace - Tags table with columns for Icon, Tag Key, Tag Value, Tag Type, Product Area, Description, and Date Modified](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-b0ce6c7b5faf99139f2d2d951480c230e51f36fe%2Fproduct-documentation_tags-workspace.png?alt=media)

* **Icon:** The visual shape and color assigned to the tag.
* **Tag Key:** The primary identifier for the tag (for example, `APP` or `DataCenter`).
* **Tag Value:** The specific value assigned to the key (for example, `Webex` or `AWS`).
* **Tag Type:** **Static** for tags you assign manually, or **Dynamic** for rule-based tags on Endpoint Experience Agents (the list may show a short summary of the rule).
* **Product Area:** The area of ThousandEyes where the tag applies (for example, Network & App Synthetics tests, Endpoint Experience Agents, or Dashboards).
* **Description:** Optional context about how the tag should be used.
* **Date Modified:** When the tag was last changed (you can sort by this column).

## Built-In versus Custom Tags

ThousandEyes provides several built-in tags out of the box (such as `Cloud`, `Enterprise`, `IPv4 Compatible`, and `Mobile`). These cannot be deleted. All previously built-in labels have been converted to built-in tags. You can also create custom tags tailored to your organization's specific routing, application, or billing needs.

For step-by-step instructions on creating and assigning tags, see [Work with Key-Value Tags](http://docs.thousandeyes.com/product-documentation/tags/working-with-tags).

## Known Limitations and API Behavior

### Fetching Tags via the API

The test details API does not return tag assignments. To retrieve tags for a specific test or agent, use the `GET /v7/tags` endpoint with the `expand=assignments` parameter. Filter the results on the client side by `assignment.type` (for example, `test` or `agent`) and the matching ID.

### Dynamic Tags API Endpoint

The UI refers to Endpoint Agent rule-based tags as **Dynamic Tags**, but the API endpoint remains `GET /v7/endpoint-labels` for backward compatibility. You can manage Dynamic Tags using either the V7 tags API or the V7 endpoint labels API; both endpoints are synchronized.

### PLG User-Defined Templates

Existing user-created test templates may still show `label` in the JSON editor. This display behavior does not affect functionality: templates continue to work, tests deployed from those templates apply tags correctly, and tags appear in the Tags UI. New user-defined templates and all certified templates fully support tags. A full migration of legacy template JSON editor behavior is planned before May 2026.


---

# 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/tags/tags-overview.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.