---
title: Managing inventory tags
summary: null
url: >-
  https://www.fastly.com/documentation/guides/security/api-security/managing-inventory-tags
---

Tags help you [organize your inventoried APIs](https://www.fastly.com/documentation/guides/security/api-security/using-api-discovery) by labeling them with categories you define, such as team ownership, functional area, or status. Tags can help you understand your API landscape at a glance by allowing you to filter your inventory to find APIs that need specific attention. This guide covers [creating](https://www.fastly.com/documentation/guides/security/api-security/managing-inventory-tags#creating-a-tag) and managing tags across your inventory.

## About the Tags tab

The Tags tab displays a list of tags you've created on each service for organizing your inventory, along with their usage counts. Tags are service-specific and cannot be shared across services. You can [edit](https://www.fastly.com/documentation/guides/security/api-security/managing-inventory-tags#editing-tag-details) a tag's name and description as well as [delete](https://www.fastly.com/documentation/guides/security/api-security/managing-inventory-tags#deleting-a-tag) a tag at any time after you create it. You can also sort the tags by their name or usage.

## Creating a tag

To create a tag:

1.   Navigate to **Security > [API Discovery](https://manage.fastly.com/security/api-discovery)** in the Fastly control panel.

2. Click the **Tags** tab.
3. Click **Create tag**.
4. In the **Name** field, enter a tag name.
5. In the **Description** field, enter a description of what this tag means and when to use it.
6. Click **Create**. The new tag appears in the list of API tags for that service.

You can create additional tags at any time as your needs evolve.

> **HINT:** Tag descriptions are visible to anyone viewing the inventory, so write them clearly with enough specificity that anyone reading them can determine the tag's general purpose. When someone sees an unfamiliar tag, they can check its description to understand what it means. You can also see how many APIs are associated with each tag in your tag settings.

## Editing tag details

To edit a tag:

1.   Navigate to **Security > [API Discovery](https://manage.fastly.com/security/api-discovery)** in the Fastly control panel.

2. Click the **Tags** tab.
3. Find the tag you want to edit in the list that appears.
4. Click the pencil <span class="inline-icons"><img src="/img/icons/pencil.png" alt="Pencil icon" /></span> next to the tag that you want to edit.
5. In the **Name** field, enter a tag name.
6. In the **Description** field, update the description of what this tag means and when to use it.
7. Click **Save**. Your changes are saved and reflected in the tag list.

## Deleting a tag

To delete a tag:

1.   Navigate to **Security > [API Discovery](https://manage.fastly.com/security/api-discovery)** in the Fastly control panel.

2. Click the **Tags** tab.
3. Find the tag you want to remove in the list that appears.
4. Click the trash <span class="inline-icons"><img src="/img/icons/trash.png" alt="Trash icon" /></span> to the right of the tag you want to delete.
5. Click **Confirm and delete**. The tag is removed from all APIs that were using it.
