Skip to main content
A tag is a short label you stick on a ticket, like refund-request, billing, bug-report, or vip. You decide what the labels mean. Tags are descriptive. They record something about a ticket without touching its status, assignee, or routing. That makes tags the place to capture whatever the built-in fields do not, so you can answer questions like “how much of this week’s volume was shipping complaints?” or keep a saved view of every ticket your team flagged as a bug. A few things teams commonly tag for:
  • A reason for contact that the ticket subject does not make obvious.
  • A product area or feature, so the right specialist can find the queue.
  • A one-off situation worth tracking, like an outage or a botched shipment batch.
Tags belong to one AI agent. If your workspace runs two agents, each keeps its own list, and a tag made in one does not show up in the other.

Tagging a ticket

Open a ticket and look for the Tags row in the Ticket Details section of the right-hand panel, just below the status.
1

Click + Add

The button sits at the end of the tag row.
2

Pick a tag

Start typing to narrow the list, then click the tag you want. It appears as a chip on the ticket right away.
3

Add more if you need to

The list stays open after each pick, so you can apply several tags in a row. Click anywhere outside it when you are finished.
If nothing in the list matches what you typed, you may see a Create “your-name” option at the bottom. Clicking it makes the tag and applies it in one go. That option only appears if you are allowed to manage tags. If you are not, you will see a note asking you to check with an admin instead. To take a tag off a ticket, click the × on its chip. That only affects this ticket. The tag itself stays available for everyone else. Chips stay in the order you added them, so a new one goes on the end instead of shuffling the row. Past five chips the rest tuck behind a +n counter, with Show more to see them all. A ticket can hold up to 20 tags. At that point + Add greys out and tells you why when you hover it.

Naming tags

Tag names are tidied up as you type so the list stays consistent and searchable. Three things happen:
  • Capitals become lowercase.
  • Spaces become hyphens.
  • Only letters, numbers, hyphens, and underscores are allowed. Anything else is rejected, so you never end up with a mangled name.
Type Refund Request and you get refund-request. Type 50% off and you are told to Use only letters, numbers, hyphens and underscores. Names can run to 50 characters and have to be unique within the AI agent. Archived tags still hold onto their names, so if a name looks taken but you cannot see the tag anywhere, it is probably sitting in the archive.
Short and predictable beats descriptive. refund-request is easier for the whole team to remember and search than customer-asked-for-a-refund.

Filtering by tag

Once tickets are tagged, Tags is available as a field in the filter builder, both for a quick look at the inbox and inside a saved view. Alongside your tags, the list offers Untagged, which matches tickets with no tags at all. Handy for spotting work your team forgot to label. You can mix it in: picking billing and Untagged together returns both groups.
A tag filter always means “at least one of these”, never “all of these”. To find tickets that have both billing and vip, add two separate conditions, one per tag. Conditions in a filter are combined with AND, so the ticket has to satisfy every one.
Saving a filter as a view is what makes tags pay off. A view like Tags is any of bug-report gives your team a standing queue they can open every morning.

Managing the tag list

Admins manage tags on Settings → Helpdesk → Tags. The page lists every tag with the number of tickets currently carrying it, so you can see at a glance which labels your team actually uses and which ones never caught on.

Creating a tag

Type the name into the Search or create a tag box, then click Create or press Enter. The same box searches the list below it, so if the name already exists you will see it appear rather than a create option, along with a note saying This tag already exists. Press Escape to clear the box.

Renaming a tag

Click the tag name, or the pencil icon on its row, and type the new one. Enter saves, Escape cancels. A rename carries everywhere. Every ticket holding the tag and every saved view filtering on it follows the new name, so you can clean up a naming mess without breaking anyone’s queue.

Archiving a tag

Tags are archived rather than deleted. Archiving retires a tag without touching your history, and you can undo it at any time. Once a tag is archived:
  • Nobody can add it to new tickets. It drops out of the picker.
  • Tickets already carrying it keep it, and saved views filtering on it keep working.
  • Its name stays reserved, so nobody creates a confusing near-duplicate.
Archived tags sit under an Archived toggle below the main list. Click the restore icon on a row to bring one back.
Reach for archive when a tag has run its course, like a label for an incident that is now resolved. Your saved views keep working, and the tag quietly stops appearing in front of agents.

Running into an archived tag

If a tag was archived after someone applied it, it stays on that ticket as a dashed chip with a small archive icon. Click the chip and you get a short explanation plus two choices: bring the tag back into use for everyone, or drop it from this one ticket. If you cannot manage tags yourself, the panel points you to the settings page so you can ask an admin. You will also meet archived tags in the picker. Type an archived tag’s name in full and it shows up marked archived, with an option to restore and apply it in one step. Typing part of the name will not surface it, which keeps retired labels out of the way during everyday searching.

Who can do what

Most support agents fall into the middle row. They can label tickets freely using the tags that exist, but cannot invent new names or bring archived ones back. That keeps the list from sprawling while still letting everyone tag their work. If you open Settings → Helpdesk → Tags without tag management access, the page tells you so rather than showing the list.

Good to know

  • Archived tags are drawn with a dashed border so they stand out from the rest.
  • Tags are internal. Customers never see them, in the chat widget or anywhere else.
  • When a teammate tags a ticket you have open, the change appears without a refresh.
  • Each AI agent can hold up to 500 tags.
  • Deleting an AI agent deletes its tags along with it.