Back to User Guide

Managing Tags

Edit on GitHub

This page is intended for Administrators who keep their workspace's audit tags organized. The Tags tab is only visible to Admin users and is accessed from Account > Tags. For how tags are created and used on audits, see 🔗 "Organizing audits with tags".

Overview

Any workspace member can create tags, so over time a workspace may end up with duplicates, misspellings, or tags that are no longer used. The Tags tab gives Admins a breakdown of every tag and the audits that use it, along with tools to rename, merge, and delete tags.

The top of the tab shows how many tags exist and how many audits are tagged. Use the Search Tags field to find a tag by name.

The tags table

ColumnDescription
TagThe tag's name. Select it to show or hide the list of audits using the tag.
AuditsThe number of audits that have this tag.
Blockers (latest scans)The total number of blockers found in the most recent scan of each audit with this tag.
CreatedThe date the tag was created.
ActionsButtons to rename, merge, or delete the tag.
When you expand a tag, each audit is listed with a link to its page, the name of the person who created it, how often it runs, and its current number of blockers. Tags that aren't used by any audits show "No audits use this tag", which makes unused tags easy to spot and clean up.

Renaming a tag

  • Navigate to Account > Tags.
  • Select the pencil icon next to the tag.
  • Enter the new name and select Rename.
The new name appears on every audit that uses the tag.

⚠️Important: You can't rename a tag to a name that another tag already uses (names are not case-sensitive). If you want to combine the two tags, use Merge instead.

Merging tags

Merging combines two tags into one. Use it when two tags mean the same thing, such as "Athletics" and "Sports".
  • Navigate to Account > Tags.
  • Select the merge icon next to the tag you want to remove (for example, "Sports").
  • In the Merge into dropdown, choose the tag you want to keep (for example, "Athletics"). The window explains how many audits will be affected.
  • Select Merge.
Every audit that had the first tag now has the tag you kept, and the first tag is deleted. Audits that already had both tags simply keep the one you kept.

💡Tip: The merge button is unavailable when your workspace has only one tag, since there's nothing to merge into.

Deleting a tag

  • Navigate to Account > Tags.
  • Select the trash can icon next to the tag.
  • Review how many audits the tag will be removed from, then select Delete Tag.
Deleting a tag removes it from every audit that uses it. The audits themselves, and their scans and results, are not affected.

⚠️Important: Deleting or merging a tag can't be undone. If you delete a tag by mistake, you'll need to create it again and re-add it to each audit.

Tag changes in the Logs

Renaming, merging, and deleting tags are all recorded on the Logs page, along with the Admin who made the change. Merge and delete entries also note how many audits were affected. See 🔗 "What gets logged".