---
title: "Tags"
slug: "tags"
updated: 2026-10-14T15:37:12Z
published: 2026-10-14T15:37:12Z
canonical: "help.commbox.io/tags"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.commbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

## Overview

Tags help organizations categorize conversations, customers, and AI Agent interactions for classification, automation, reporting, and analysis. Different tag types serve different purposes, including general classification, Knowledge Base topics, and AI Agent performance evaluation.

You can create, edit, delete, and organize tags into groups, assign ownership to specific teams, and define where tags should be used.

CommBox also supports additional tag types, such as Intent and Customer Satisfaction tags, which are managed through their respective features.

You can also create all tag types using the **CommBox API**.

## Key Considerations

- **Tag Type** is used to categorize tags according to their business purpose, making them easier to organize and manage.
- CommBox supports six tag types:
  - **Tag** – General-purpose tags for conversations and customers.
  - **Goal** – General-purpose tags for conversations and customers.
  - **Miss** – General-purpose tags for conversations and customers.
  - **Topic** – Tags used to categorize Knowledge Base items, conversations, and customers, helping organize related information.
  - **Satisfaction** – Configured in the Customer Satisfaction settings. When a customer responds to a satisfaction survey, the corresponding tag is automatically added to the conversation, with an optional emoji. Agents cannot delete Satisfaction tags. See the [Customer Satisfaction guide](https://help.commbox.io/docs/customer-satisfaction).
  - **Intent** – Automatically added to conversations when an intent is identified. See the [Intents guide](https://help.commbox.io/docs/intents) for more information.
- **Tag Groups** allow organizations to organize related tags for easier management.
- **Valued Tags** can be configured with a range of numeric values and a default value. These values provide additional information about the tagged conversation or customer and can help when filtering conversations.
- **Eva**, CommBox's AI Agent evaluator, can use any tag that has an **Eva tag description** to evaluate AI Agent conversations. Eva uses the description, rather than the tag name, to determine when to apply the tag. Evaluation tags are added when a conversation is **Resolved**.
- **Rules** can be triggered by tags and can automatically add tags to conversations or customers. See the [Rules guide](https://help.commbox.io/docs/rules) for more information. ![tags in Rules.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/tags%20in%20Rules.png)
- **Automation Bots** can add tags to conversations or customers at any step in a Flow. In the relevant step's properties, select **Set Tags**, click **+ Add Tag**, select the desired tags, and click **OK**. ![tags in bot.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/tags%20in%20bot.png)
- **Team Assets** control tag availability according to the organization's team hierarchy. Tags can be managed through the Teams module or the Tags management page. See [Understanding Teams Assets](https://help.commbox.io/docs/understanding-teams-assets) for more information.

## Displaying Tags

Tags are displayed with their **group name** (in bold), **tag name**, and **value**, when applicable.

For valued tags, only the value is displayed. Hover over a tag to view its complete information. ![tags display 2025.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/tags%20display%202025.png)

When there is insufficient space to display all tags, click the **+** icon next to the visible tags to view the complete list. ![tags display 2025 - 3.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/tags%20display%202025%20-%203.png)

## Managing Tags

![Tags module.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/Tags%20module.png)

Navigate to **Settings** > **Tags** in the **Settings & Tools** section to view and manage existing tags.

The **Tags** tab displays all available tags and their properties:

- **Tag Name** – The name of the tag.
- **Tag Type** – The tag's classification, such as Tag, Topic, Goal, or Miss.
- **Related Group** – The group to which the tag belongs, if applicable.
- **Owner Team** – The team or organization that owns the tag.
- **Used for** – Icons indicating where the tag can be used: Conversations, Customers, or Knowledge Base items.
- **Unit** – Indicates whether the tag has a numeric value.

### Searching for a Tag

You can search for tags by name or filter the list by **Tag Type**, **Related Group**, or **Used for**.

Click a column heading to sort the list. Use the arrows next to the column heading to switch between ascending and descending order.

### Adding a Tag

![new tag creation.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/new%20tag%20creation.png)

1. Navigate to **Settings** > **Tags** in the **Settings & Tools** section, and click **+ Add Tag**.
2. Complete the following fields:
  1. **Tag Name** – Enter a name for the tag.
  2. **Tag Type** – Select a category for the tag based on its business purpose.
  3. **Related Group** – Select the group to which the tag belongs, if applicable.
  4. **Owner Team** – Select the team that owns the tag, or **Organization** to make it available at the organization level.
  5. **For Conversations** – Select to enable the tag for conversations.
  6. **For Customers** – Select to enable the tag for customers.
  7. **For Knowledge Base** – Select to enable the tag for Knowledge Base items. This option is available only for **Topic tags**.
  8. **Unit** – Select **Non-value** for a tag without a numeric value, or **Number** for a tag that stores a numeric value. For numeric tags, configure the value range and default value.
  9. **Eva tag description** – Enter instructions describing when Eva should apply the tag during AI Agent conversation evaluations.
3. Click **Add** to save the tag.

**Note:** Eva uses the **Eva tag description**, not the tag name, to determine when to apply evaluation tags. Provide clear instructions describing the conditions under which the tag should be assigned.

### Editing a Tag

1. Locate the tag in the Tags list.
2. Click the desired row or the **Edit** (pencil) icon.
3. Update the required fields.
4. Click **Save** to apply your changes.

### Deleting a Tag

1. Locate the tag in the Tags list.
2. Click the **Delete** (trash) icon.
3. Confirm the deletion.

**Important:** Deleting a tag permanently removes it from all locations where it is used. This action cannot be undone.

## Managing Tag Groups

![Tag Groups Management tab.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/Tag%20Groups%20Management%20tab.png)

**Tag Groups** help organize related tags according to the organization's business needs.

Navigate to **Settings** > **Tags** and select the **Tag Groups Management** tab. The table displays the number of tags associated with each group. Hover over the number to view the list of tags belonging to that group.

### Creating a Tag Group

1. Open the **Tag Groups Management** tab and click the **+Add tag group** button.
2. Enter a name for the group. ![Add tag group.png](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/Add%20tag%20group(1).png)
3. Save the group by clicking **Add**.

Once created, the group can be selected in the **Related Group** field when adding or editing tags.

### Editing a Tag Group

1. Locate the group in the Tag Groups Management tab.
2. Click the **Edit** (pencil) icon.
3. Update the group name.
4. Save your changes.

**Note:** Only the group name can be edited from this tab. To modify tags associated with the group, edit them individually from the **Tags** tab.

### Deleting a Tag Group

Deleting a Tag Group also permanently deletes all tags associated with it. This action cannot be undone. Changes are reflected after a browser refresh.

**Important:** To preserve the associated tags, edit each tag and remove its association with the group before deleting the group.

Once the group contains no tags:

1. Locate the group in the **Tag Groups Management** tab.
2. Click the **Delete** (trash) icon.
3. Confirm the deletion.

### Tags in Teams

Tags are managed as **Team Assets**. The **Owner Team** setting determines which teams can access and use each tag.

Navigate to **Settings** > **Teams** to view and manage tags associated with a specific team or the organization.

You can also create tags directly from the Teams module and manage their availability according to the organization's team hierarchy.

Click [here](https://help.commbox.io/docs/understanding-teams-assets) to learn more about managing Team Assets.