# Tags

BotDistrikt lets you analyze your chat traffic with ease with **Tags.** Tags are used classify and organize different types of content under your bot account. They are primarily used for managing and segmenting the bot's responses and the users interacting with your bot. This will allow for easy grouping, identifying, and finding content relevant to your chatbot’s operation.

<figure><img src="/files/xktPTfQo7X1bW3bdYlVb" alt=""><figcaption><p>Tags Dashboard</p></figcaption></figure>

Tags are only used for the bot’s responses such as **Cards, Users, Documents, Messages, Images, Text, Audio, Video, Source and Wrong Responses (WR).**

### Add New Tag <a href="#adding-new-story" id="adding-new-story"></a>

To add a new Tag, click on <img src="/files/O8CR3GoebQsJ2zGPTHmi" alt="" data-size="line"> at the top right corner of the page. Then select the type of medium you would like to tag.

<figure><img src="/files/FZu57sQ4EhaCnx9ITz2c" alt=""><figcaption><p>Select Tag Type</p></figcaption></figure>

<figure><img src="/files/6NgMmIVHZRMYKxvIhpBc" alt=""><figcaption><p>Fields to Populate</p></figcaption></figure>

Below is an explanation of the key fields and steps involved:

1. Type - Determines the response medium in which the tag will be applied to.
2. Name - Enter the name of the tag.
3. Synonyms - Add alternative names or keywords for the tag.
4. Description - Provide a detailed description of the tag's purpose or application.

Once the tag is saved, it is successfully created and becomes available for use. You can begin assigning the tag to selected responses under the Tag field within the respective response settings.

To review where the tag has been applied, users can click on the View button on the tags dashboard. This action navigates them to the specific response medium, such as Cards, Messages, or Documents, with the relevant filters automatically applied.&#x20;

<figure><img src="/files/WtcnOgtUDFR4sZ1nKqaK" alt=""><figcaption><p>Viewing Tagged Responses.</p></figcaption></figure>

### Tag Examples

* [Cards](https://docs.botdistrikt.com/responses/cards)

If a Tag called "sides" is created for a card; when a user searches for sides, the card will appear.

![Tagging "sides" to a card](/files/-MG9xWMUo3I1Y5PJHfyS)

![User prompting for sides will get a response with cards tagged with "sides".](/files/-MG9xhV82e0PSe3S8w3A)

* [User](https://docs.botdistrikt.com/features/users)

<figure><img src="/files/ZY7ORmdbK3fC381Z0tpU" alt=""><figcaption><p>Select User to Update User Tags</p></figcaption></figure>

Enter specific tags for leads or broadcast list recipients. For example, whether a customer is an Enterprise, warm leads, premium customers, etc. These tags will be available in the **User** dashboard.

* [Document](https://docs.botdistrikt.com/features/responses/documents)

Similar to users, you can select 'document' from the tags dropdown to associate tags with a document. Documents such as menus or catalogs can be tagged to trigger it with specific keywords.&#x20;

* [Message](https://docs.botdistrikt.com/features/rules/conditions/message)

Create tags associated with messages to help with creating conditions. &#x20;

* [Image](https://docs.botdistrikt.com/features/responses/images)

Similar to cards, if an image is tagged with specific tags, for example, "fish", and the user mentions it during the conversation,&#x20;

"Does your menu include fish?"

Then the bot shares the image tagged with fish with the user.&#x20;

* [Text](https://docs.botdistrikt.com/features/responses/text)&#x20;

Similar to messages, create tags for text-based responses to recognize user meanings, contexts, and intents and enable your bot to send relevant responses.

* [Audio](https://docs.botdistrikt.com/features/responses/audios)

Create a tags list to trigger audio responses for your bot.&#x20;

* [Video](https://docs.botdistrikt.com/features/responses/videos)

Similar to cards and images, if a video is tagged with specific tags, for example, "cooking tutorial," and the user mentions it during the conversation,&#x20;

"Can you show me a cooking tutorial for pasta?"&#x20;

Then the bot shares the video tagged with "cooking tutorial" with the user.

* [Sources](https://docs.botdistrikt.com/features/sources)

Create a tags list to be assigned to sources, such as documents.&#x20;

* [Wrong Responses (WR)](https://docs.botdistrikt.com/features/inbox/wrong-responses)

Create a tags list for validation purposes and to segment them.


---

# 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.botdistrikt.com/features/settings/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.
