# Contextual Search - Tagging

Add tags to teams, escalation policies and users to easily search for them

Contextual Search uses tags to enable faster searches for objects such as [Teams](/account-admin/teams), [Escalation Policies](/incident-management/schedules/escalation-policies) and [Users](/account-admin/manage-users). Large organizations can use tags to add metadata to indirectly related objects and identify their relationships. Contextual Search also helps Responders and Managers navigate to the correct objects, and reassign incidents quickly and easily.

> **Availability:** Contextual Search is available on the following pricing plans: Business, Digital Operations (legacy) and Enterprise for Incident Management. Please [contact our Sales Team](https://www.pagerduty.com/contact-us/#contact-sales/) if you would like to upgrade to a plan featuring Contextual Search.

> **Required User Permissions:** Users with the following roles can **create** and **remove** tags by default:
>
> - Account Owner
> - Admin/Global Admin
>
>  Account Owners can optionally allow Team Managers to create tags by navigating to **User Icon**  →  **Account Settings**  →  **Tagging** tab and selecting **Team Managers can create new tags (in addition to Account Owner and Global Admins)**.
>
> Users with the following roles can **add** tags to objects:
>
> - Account Owner
> - Admin/Global Admin
> - Manager
>   - Users with a Manager [Team role](/account-admin/advanced-permissions#team-roles) can to add tags to their Team and its escalation policies, but not its users.

## Add Tags to a User, Team or Escalation Policy

Tags are designed to be added to each object category (i.e., Teams, escalation policies and users) separately. For example, if you add a "Payments" tag to a Team, the tag will not appear on associated escalation policies or users. In this example, you would need to also add it to any associated escalation policies and users individually.

> **Tag Formatting:** - Pressing the space bar ends the tag (like pressing Enter/Return). To separate words within a tag, use hyphens (-) or underscores (\_).
> - There is a maximum of 191 characters per tag.
> - You can use a combination of letters, numbers, and special characters.

1. In the top navigation bar, navigate to **People** and select **Users**, **Teams** or **Escalation Policies**, depending on which object you want to tag. Select your preferred object to view its details page.
2. To the right of the object's name, click **Add Tags**.

3. If you would like to create a new tag, input a name for the tag and press **Enter**. If you would like to add an existing tag to the object, search and/or select it from the dropdown.
   1. Repeat this step to add multiple tags.
4. Click **Save**.

## Remove Tags from a User, Team or Escalation Policy

Removing a tag is similar to the steps for [adding one](#add-tags-to-a-user-team-or-escalation-policy), but in reverse.

1. Navigate to **People**, select **Users**, **Teams** or **Escalation Policies**, depending on which object you would like to remove a tag from. Select the object to drill down to its details page.
2. To the right of the object's name, click .
3. Click  on the tag you want to remove.
4. Click **Save**.

## Delete Tags

The web app does not currently offer a way to completely delete a tag from your PagerDuty account. You can, however, use the REST API to do this. For more information, please see [Delete a tag](/developer/api/reference/rest/tags/delete-tag).

## Filter Objects by Tag

Tags are particularly useful when you'd like to restrict search results to a specific set of objects.

1. Navigate to **People** and select **Users**, **Teams** or **Escalation Policies** depending on which object you would like to filter.
2. Next to the search bar, click the  **Filter By Tags** dropdown and search for your tag, or browse the dropdown.

## Reassign an Incident Using Tags

1. On an incident's detail page, click **Reassign**.
2. In the **Reassigning incident to…** modal, enter the tag name or browse tags in the tag selector dropdown.
   1. With a tag selected, only matching users, escalation policies and escalation levels will appear in the results.
3. Select your desired user, escalation policy or escalation level.
4. Click **Reassign**.