Manage tags

Once tags are in your tag library, you can edit, delete, move, merge, remove references, filter, and export them from the Manage tags page. These actions help you keep your tag library accurate, consistent, and free of duplicates over time.

To access the Manage tags page, navigate to Content tools () > Tags in the left navigation bar.

For single and bulk tag actions, select the checkboxes next to the tags to reveal the bulk actions toolbar.

When to manage tags

• Edit a tag when its name, description, or group assignment needs to be updated.
• Delete a tag when it is no longer relevant and has no active dependencies.
• Move a tag to a different group when your tag library structure has changed.
• Merge tags when you have duplicate or near-duplicate tags that should be consolidated into one.
• Remove references when you want to detach a tag from specific content without deleting it from the library.

Edit a tag

Editing a tag updates its name, description, or group assignment across all content it is applied to. Dependencies are preserved and only the displayed tag details change.

Select the checkbox next to the tag and click Edit from the bulk actions toolbar. Update the Tag name, Description, or Group as needed and click Update.

Move a tag

Moving a tag reassigns it to a different tag group without changing its name or dependencies.

Select the checkboxes next to the tags you want to move and click Move from the bulk actions toolbar. Select the destination group from the dropdown and click Move.

Merge tags

Merging consolidates two or more tags into a single tag. All dependencies from the merged tags are transferred to the target tag, and the source tags are removed from the library.

Select the checkboxes next to the tags you want to merge and click Merge tags from the bulk actions toolbar. In the Merge tags panel, select the target tag that all dependencies will be transferred to, and click Merge.

Remove references

Removing references detaches a tag from selected articles, category pages, or files without deleting the tag from the library. The tag remains available for future use.

Select the checkboxes next to the tags and click Remove references from the bulk actions toolbar. Click Yes to confirm.

Delete a tag

Deleting a tag removes it from all articles, category pages, and files it is applied to. This action cannot be reversed.

Select the checkbox next to the tag and click Delete from the bulk actions toolbar. To delete multiple tags at once, select their checkboxes and click Delete. Click Yes to confirm.

Filter tags

Use the Filter option to narrow down the tags displayed on the page.

Click the Filter icon at the top right of the Manage tags page. Set the criteria and click Apply.

Export tags

Click Export CSV at the top right of the Manage tags page to download all tags in your project as a CSV file. The export includes tag name, group name, description, articles, page category, and files in Drive.

Best practices

• Remove tag dependencies before deleting a tag so you can reassign them rather than losing the association entirely.
• Use merge when you find duplicate tags with slight spelling variations, for example, "API" and "APIs".
• Use move when reorganising your tag library into groups, rather than recreating tags from scratch.
• Use remove references instead of delete when you want to detach a tag from specific content but keep it in the library.
• Audit your tag library periodically using the Filter and Export CSV options to identify unused or redundant tags.

FAQ