Skip to content

Tags

Free-form grouping. A lead can carry several tags at once, which is what makes them different from a status (one at a time) or a stage (one at a time, and it moves).

Useful for things that cut across your process: "Referral", "Walk-in", "Price sensitive", "Monsoon campaign".

Before you start

  • You need the tenant.settings.manage permission.

Steps

  1. Go to Settings → Tags.
  2. Add a tag. Names must be unique within your workspace.
  3. Rename or remove as needed.

What this affects elsewhere

  • Automation can add and remove tags as an action.

Not available yet. Adding a tag to a lead or contact by hand. Tags are currently applied by automation rules only — there is no tag picker on a lead yet.

What you cannot change later

A tag that is on any record cannot be deleted. The screen will tell you how many records carry it and suggest renaming instead, because deleting it would silently remove that grouping from every one of them.

Renaming is always safe. Records keep the tag; it simply reads differently.

Unlike statuses and call outcomes, tags have no retired state — they are either there or removed, and removal is only allowed when nothing uses them.

If it does not work

What you see What it means What to do
"This tag is on N records" It is in use Rename it instead
"A tag with that name already exists" Names are unique per workspace Pick another name
You cannot add a tag to a lead That is not built yet Use an automation rule

Last checked against the product on 2026-10-10. Needs the tenant.settings.manage permission.