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

# Chat tagging

> Organize chats in Piebald with automatic or manual tagging.

<Badge color="green">Available in [Piebald Pro](https://piebald.ai/pricing)</Badge>

If you have a lot of chats, it can be helpful to assign tags to them.  You can filter chats by their assigned tags, and they can tell you at a glance what areas a particular chat are about.

Tags are created in **Settings → Chat Tags.**  Chat tags require [Piebald Pro](https://piebald.ai/pricing).

## Automatically creating tags

Tags can be automatically assigned to a new chat by an AI when it generates a title for it.  The system prompt for the **Title & Tag Generation** built-in profile must include instructions to generate tags.  By default it does; if it doesn't, click "Reset to Default" to reset it to a default system prompt that includes the instructions.

Here's a screenshot of the title/tag generations model suggesting a new tag:

<img className="shadow-md rounded-xl" width="900" alt="Screenshot of an new AI-proposed 'language-comparison' tag" src="https://mintcdn.com/piebald/6tQfHBAxXertJR1r/imgs/v0-1-6/new_tag_proposed.png?fit=max&auto=format&n=6tQfHBAxXertJR1r&q=85&s=0ee76730d7770547a4dcc9ba38ea21de" data-path="imgs/v0-1-6/new_tag_proposed.png" />

Automatic existing tag assignment and new tag suggestion are enabled by default; go to **Settings → Title & Tag Generation** and turn off **Enable automatic chat tagging** or **Allow LLM to suggest creating new tags** to disable them.

## Filtering chats by tag

If you have tags created and assigned to chats, you can filter chats by tags.  Click the <Icon icon="funnel" /> icon in the top-right corner of the chat sidebar and select the tag or tags to filter by:

<img className="shadow-md rounded-xl" width="300" alt="Image" src="https://mintcdn.com/piebald/J4noBc8CRvusXw9Z/imgs/v0-1-9/filter_chats_by_tags.png?fit=max&auto=format&n=J4noBc8CRvusXw9Z&q=85&s=f5f266100912c46021a882c73ca02cda" data-path="imgs/v0-1-9/filter_chats_by_tags.png" />

## Manually tagging a chat

If you'd like to manually assign a tag to a chat, click on the <Icon icon="ellipsis" /> icon on a chat in the sidebar and choose **<Icon icon="tag" /> Tag**.  There must be some tags created in the settings beforehand.

<img className="shadow-md rounded-xl" width="300" alt="Image" src="https://mintcdn.com/piebald/sDAg3NkddSXbITtn/imgs/tagging_a_chat.png?fit=max&auto=format&n=sDAg3NkddSXbITtn&q=85&s=c02eb9afc322cb2e2e1a7f23cfa81fcf" data-path="imgs/tagging_a_chat.png" />

Then select one or more tags from the dialog and click **Save Tags.**