# Work with Key-Value Tags

## Create a New Tag

You can create tags centrally from the Tags workspace or inline while configuring an asset.

To create a tag from the Tags workspace:

1. Navigate to **Manage > Tags**.
2. Select **Add tag**.
3. In the **Key** field, enter a primary identifier (up to 128 alphanumeric characters, hyphens, or underscores).

   If you plan to use this tag in an OpenTelemetry streaming integration, avoid spaces and other non-compliant characters in the tag key. Non-compliant keys are excluded from streamed data. For details, see [Tags as Attributes](https://docs.thousandeyes.com/product-documentation/integration-guides/opentelemetry/data-model/data-model-v2/metrics#tags-as-attributes).
4. In the **Value** field, enter the specific value (optional, up to 128 characters).
5. Under **Select shape**, select an icon to represent the tag (such as a circle, triangle, or server icon).
6. Under **Select color**, select a color for the tag.
7. (Optional) Enter a **Description** to help other users understand the tag's purpose.
8. Under **Select tag type**, choose **Static tag** or **Dynamic tag**. Dynamic tags apply only to Endpoint Experience Agents and use rules to assign tags automatically; see [Manage dynamic tags for Endpoint Agents](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/configuring/dynamic-tags).
9. Under **Assign product area to tag**, select the product area for the tag (for example, Network & App Synthetics tests or agents, Endpoint Experience tests, Dashboards, or Connected Devices tests).
10. Select **Save and assign items** to create the tag. Follow the prompts to assign items now, or finish the flow if you do not need to assign any yet.

![Add New Tag side panel - Key, Value, shape, color, description, tag type, product area, and Save and assign items](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-a6523cab13a2c5350d516b1267ef47b261d8bcb2%2Fproduct-documentation_tags-create-modal.png?alt=media)

## Create a Tag Inline

When configuring an asset, such as a test or an agent, you can create a tag on the fly:

1. Select the **Add tags** field on the asset configuration page.
2. Start typing your desired tag. Use a colon (`:`) to separate the key and the value (for example, `Europe: Amsterdam`).
3. If the tag does not exist, the dropdown will prompt you to **Create New Tag**.
4. Select **Save**. The new tag is automatically applied to the asset and inherits the default icon and color.

## Assign Tags to Assets

To assign an existing tag to an asset:

1. Open the configuration page for the test, agent, or dashboard.
2. Locate the tag selector field.
3. Select the field to open the dropdown menu. You can scroll through the alphabetical list or type to search.
4. Select the tags you want to apply. You can select multiple tags for a single asset.

## Manage Assigned Items from a Tag

You can assign a tag to multiple assets (such as tests or agents), or remove the tag from them, directly from the Tags workspace.

1. Navigate to **Manage > Tags**.
2. Select the **...** (options) menu next to the tag you want to modify.
3. Select **Manage Assigned Items**.

![Tag detail panel with overflow menu open showing Manage Assigned Items](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-b0b0a2a71cf93931d8cff24d2e70854218fd5c55%2Fproduct-documentation_tags-manage-assigned-items-menu.png?alt=media)

4. In the dialog that appears, select or deselect the items you want to associate with the tag.
5. Select **Save**.

## Filter Using Tags

Tags allow for advanced filtering across the ThousandEyes platform.

* **In dashboards:** Use the global filter or widget-level filters to isolate data. For example, filtering by `APP: Salesforce` will update all applicable widgets to show only data related to that tag.
* **In views:** Use the tag selector to filter test results or group tests by specific keys.
* **In alert rules:** Use tag-based selectors with AND/OR logic to target tests and agents.

## Edit or Delete Tags

1. Navigate to **Manage > Tags**.
2. To edit, select the **Edit** icon next to the tag. Note that changing a tag's key or value will update it across all assigned assets.
3. To delete, select the checkbox next to one or more tags, and select **Delete**. *Note: Deleting a tag removes it from all associated assets. This action cannot be undone.*


---

# 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/working-with-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.