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

# Tags

> Create and manage tags to organize contacts, trigger automations, and segment your audience in the HoopAI Platform.

<div style={{position: "relative", paddingTop: "56.25%", marginBottom: "1.5rem"}}>
  <iframe src="https://player.mediadelivery.net/embed/622351/323ab3f4-13f9-4393-81f3-f5c615aa8ab2?preload=true" loading="lazy" style={{border: "none", position: "absolute", top: 0, height: "100%", width: "100%"}} allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture" allowFullScreen={true} />
</div>

The Tags section provides a central location for managing all contact tags in your account. While tags can be created in other areas (directly on contacts, through automations, etc.), the Tags settings page lets you view, edit, rename, and delete existing tags across your entire account.

Navigate to **Settings > Tags** to get started.

<Frame caption="Tags management">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/dif11QvMekN9AcKH/images/settings-tags.png?fit=max&auto=format&n=dif11QvMekN9AcKH&q=85&s=5125923604c879d11eb53589e2e62877" alt="Tags" width="1109" height="339" data-path="images/settings-tags.png" />
</Frame>

## What tags do

Tags are labels you attach to contacts for quick identification and segmentation. They are useful for:

* **Quick filtering** — create smart lists of contacts with a specific tag
* **Trigger automations** — use tag additions/removals as workflow triggers
* **Segment campaigns** — target contacts by tag in email and SMS campaigns
* **Merging contacts** — tag-based deduplication and contact merge triggers
* **Sales routing** — automatically assign contacts to agents or pipelines based on tags

## Managing tags

### Creating a new tag

Tags are most commonly created directly when editing a contact record or through a workflow action. In the Tags settings page, you can also:

1. Click **Add Tag** or the + icon.
2. Enter a name for the tag.
3. Save.

### Searching for tags

Use the search bar at the top of the Tags page to quickly find a specific tag by name.

### Renaming a tag

1. Find the tag you want to rename.
2. Click the edit (pencil) icon.
3. Enter the new name and save.

<Note>
  Renaming a tag updates it everywhere it is used — all contacts with that tag will reflect the new name immediately.
</Note>

### Deleting a tag

1. Find the tag you want to delete.
2. Click the delete (trash) icon.
3. Confirm deletion.

<Warning>
  Deleting a tag removes it from all contacts that have it and from any automations or smart lists that reference it. Review your workflows and lists before deleting commonly used tags.
</Warning>

<Frame caption="Workflow trigger — use tag added/removed as a trigger to enroll contacts in automated sequences">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/JAA-4AwPEX6sdRhx/images/automation-a-simple-calendar-workflow-6-contact-20tag.png?fit=max&auto=format&n=JAA-4AwPEX6sdRhx&q=85&s=8864f7c8601035504be6f221ffe222af" alt="Tag workflow trigger" width="1105" height="523" data-path="images/automation-a-simple-calendar-workflow-6-contact-20tag.png" />
</Frame>

<Frame caption="Contact filtering — create smart lists filtered by tag to quickly segment your audience">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/evc3PeLCJMLz3iUG/images/conversations-filters-actions.png?fit=max&auto=format&n=evc3PeLCJMLz3iUG&q=85&s=9b6869af9ee0d353c0027db5ceeb7fef" alt="Tag filtering contacts" width="607" height="646" data-path="images/conversations-filters-actions.png" />
</Frame>

## Tag best practices

<Tip>
  Use a consistent naming convention for tags to keep your account organized. For example: `lead-source-google`, `lead-source-facebook`, `status-hot`, `status-cold`, `campaign-spring-2025`.
</Tip>

* Use tags for contact categorization that does not fit into standard fields (status, source, campaign)
* Avoid creating too many similar tags — consolidate where possible
* Regularly audit unused tags in the Tags settings page and remove ones no longer in use
* Document your tagging conventions so your whole team applies them consistently

## Related articles

* [Contacts overview](/contacts/overview)
* [Smart lists](/contacts/smart-lists)
* [Automations](/automation/overview)
* [Custom fields](/settings/custom-fields)
