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

# Organize leads with tags

> Create, edit, color, apply, filter, and safely delete the tags your team uses to organize leads.

Tags give your team a shared way to classify leads without changing an Agent stage or collected variable.

Tags do not have a permanent sidebar item. Press **Command + K** or **Control + K** and search for **Tags**, or open [Tags](https://app.getnexor.ai/tags) directly.

## Manage the tag list

The Tags page lets you:

* search by tag name;
* create a tag inline;
* edit its name or description inline;
* select its color;
* see its usage count, last-applied time, and creation time; and
* delete it from the row menu.

Names should describe a reusable fact, such as `VIP`, `Needs documents`, or `Renewal 2026`. Use the description to tell teammates when to apply the tag.

## Apply tags to a lead

Open a lead and use the **Tags** section in its details. You can select an existing tag or create one without leaving the lead.

To find tagged leads later, open **Leads → Filters → Tags** and select the tag. Tags are workspace labels, so the same tag can be used across several Agents.

<Note>
  A tag complements the pipeline. Use a stage for the lead's current process state and a tag for an additional category that can remain useful across stages.
</Note>

## Change a tag

Editing a tag's name, description, or color updates the shared tag. Leads that already use it keep the tag under the updated definition.

## Delete a tag

Deleting a tag removes it from every lead that currently uses it. The action cannot be undone.

<Warning>
  Before deleting a widely used tag, filter the Leads list by that tag and confirm that your team no longer needs the grouping. Deleting the tag does not delete the leads.
</Warning>

## Use the API

<CardGroup cols={2}>
  <Card title="List tags" icon="tags" href="/docs/en/api/tags/list-tags">
    Read the current workspace tag catalog.
  </Card>

  <Card title="Create a tag" icon="tag" href="/docs/en/api/tags/create-tag">
    Add a reusable tag from an external integration.
  </Card>
</CardGroup>