Note: Tags are currently only available to a selected number of customers through our Early Access Program.
Content tags allow you to assign tags to entries and assets in your space, which can then be used to find and organize content within the web app. This can be especially helpful if you have multiple teams of contributors working together within one space. Content tags can help editors quickly and easily identify which content is most relevant for them.
The Tags page is where you can see and create tags, as well as rename or delete an existing tag. Renaming and deleting tags instantly updates all entries and assets containing the tag.
Tags consist of a name and an ID. An ID can only contain letters, numbers, periods, hyphens and the underscore symbol.
To create tags:
In the web app, click Settings > Tags. The Tags page will open.
On the right-hand side, click the Create new tag button.
The Tags dialog will open. Fill out the fields with your desired information.
When satisfied, click Save tag to finish. Alternatively, if you wish to add multiple tags, click Save and create another.
Tip: Use prefixes in tag names separated with a symbol (hyphen, colon, dot, underscore or hash) and we’ll show them grouped by prefix in entries and assets, e.g.,
Year: 2019 and
Once tags have been created for your space, you can add them to entries and assets. Any user with entry editing permissions may add or remove tags.
To add tags to an entry:
Navigate to your desired entry, click on the Tags tab, and search for the tags you wish to add.
You can remove a tag by clicking on the x to the right of the tag name.
Adding tags to assets is identical, except that the tags are located under the asset fields.
If you have a lot of content to tag, you don't want to spend a lot of time adding tags one by one. Luckily, you can add tags to multiple entries and assets at once.
To tag multiple entries:
In the web app, click Content in the navigation bar.
From the list, select the entries you want to tag.
At the top of the list, click Add or remove tags.
In the editor, add or remove tags as desired.
Click Save when finished.
Tip: Use Ctrl + Z (Cmd + Z on Mac) to undo your changes.
Bulk editor: available on both on the content and media pages.
The bulk editor has a list of all tags on any of the selected entries or assets, along with a number showing how many of them contain each tag.
Click Apply to all to apply that tag to all selected entries or assets.
After clicking Apply to all, you will have the option to Undo, which ensures the tag will not be changed for any of the selected entries and assets.
Click the X next to the tag to remove it from all selected entries or assets.
You can also search for tags to add to all selected entries and assets in the bulk editor. Any tag added to your selection will be shown in orange, while removed tags will be displayed as a faded orange.
You can also search for entries using tags with a variety of filters. This searches all your entries or assets, no matter the content type.
Include one of
All entries or assets that contain at least one of the provided tags
Include all of
All entries or assets that contain all of the provided tags
Any entries or assets without the provided tags
Entries or assets that contain at least one tag
Entries or assets that are not tagged
You can do some clever searching by combining the any and not filters. For example, you can retrieve all entries that are tagged but do not contain a specific tag:
Lastly, you can choose to view tags in the list of entries in the content tab. Click the gear symbol in the top-right of the tags table, and find Tags in the Available Columns section.
For more detail on using filters, see our Content search article.
Tags can also be used with saved views. See our Views article for more information.
By default, only space admins can access the tag settings page and add, delete, and rename tags. Space admins can also grant this permission to non-admin roles.
To grant the manage tags permission:
Navigate to Settings > Space settings > Roles & permissions.
Find the role you’d like to grant the manage tags permission to.
Click the triple-dot icon and select Edit.
Select the checkbox "Can create and manage tags".
Currently tags are intended to be used to organize and search for content within Contentful. They are only returned in the Contentful Management API, and are not exposed through the Delivery API, so they are not suitable to use for SEO.
You can add tags to assets to store metadata, but tags are only returned in the Contentful Management API. They will not be exposed through the Contentful Delivery API.
Not yet, but stay tuned.
Tags are currently only available to a select number of customers through the Early Access Program.