- Help center home
- Getting started
- Content model
- Managing content
- Working with entries
- Working with media
- Working with translations
- Managing users
- Roles
- Account settings
- Administration
- Experiences
- Content orchestration
- Compose
- Launch
- Workflows
- Guides
- Certification and training
- Contentful glossary
- Manage cookie consent
- Apps
- Usage Limit
- Marketplace
- How to get help and support
- Knowledge Base
Deleting tags
On this page
Prerequisites to deleting tags
A tag can be deleted only if there are no entries and assets assigned with it.
A public tag becomes available on the Content Delivery API (CDA) when an entry or asset assigned with this tag is published. When removing a public tag from an entry or asset, make sure to publish the changes in order to remove the tag from the CDA.
NOTE: Removing a public tag from content without publishing the changes will only remove it from the CMA, but not the CDA.
How to delete a tag
To delete a tag:
In the Contentful web app, navigate to the Settings tab and select Tags. The Tags page is displayed.
Optional: Search for the required tag by typing its name in the search field.
Go to the required tag, click on the actions menu on the right and select Delete tag. The Delete tag window is displayed.
Mandatory: Select Make tag unavailable for all roles checkbox. NOTE: Deleting a tag might affect access to content of users with tag-based permissions. For more information, please read Content permissions with tags.
Click Delete and remove. Your tag is deleted.
Resolving issues
Deleting a tag can fail because of one of the following reasons:
There is content that is still assigned with the tag.
Tagged content was archived.
Public tag was removed from published content but changes were not published (public tag is still available on the CDA).
The instructions below explain how to troubleshoot and delete the tag.
Content is still assigned with the tag
In the Content tab, filter your content by a tag(s) that you would like to remove. The relevant search results are displayed.
Select all the entries or assets and click Add or remove tags.
Remove the required tag by clicking x.
Tagged content was archived
In the Content tab, filter your content by a tag (tags) that you would like to remove. The relevant search results are displayed.
Then, filter your content by Status and select Archived as a filter value.
Select all the entries or assets and click Unarchive. Your content is unarchived.
Select all the entries or assets again and click Add or remove tags.
Remove the required tag by clicking x.
Archive the content again by repeatedly selecting all the entries or assets and clicking Archive.
Public tag was removed from published content but changes were not published
NOTE: To be able to delete a tag with visibility "Public", make sure to publish changes to an entry or asset after removing the tag from it. Only after that, delete your public tag itself.
If a public tag can't be deleted because content wasn't published after removing the tag, it is necessary to search for the content and publish the changes. This can be accomplished in one of the following ways:
In the Content tab, filter your content by Status and select Changed as a filter value. Select the filtered entries or assets and click Republish. Now the changes are published and you can delete the tag.
Query all content tagged with the tag on the Content Delivery API