Content tags 

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.

Creating tags

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: 

  1. In the web app, click Settings > Tags. The Tags page will open.

  2. On the right-hand side, click the Create new tag  button.

  3. The Tags dialog will open. Fill out the fields with your desired information.

  4. When satisfied, click Save tag to finish. Alternatively, if you wish to add multiple tags, click Save and create another.

tags-empty-state

create new tagtags page

Grouping tags

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 Year: 2020.

Tags grouping in entries

Assigning tags to entries and assets

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:

  1. Navigate to your desired entry, click on the Tags tab, and search for the tags you wish to add.

  2.  You can remove a tag by clicking on the x to the right of the tag name.

tags-entry

Adding tags to assets is identical, except that the tags are located under the asset fields. 

Adding tags to multiple entries at once

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:

  1. In the web app, click Content in the navigation bar.

  2. From the list, select the entries you want to tag.

  3. At the top of the list, click Add or remove tags.

  4. In the editor, add or remove tags as desired.

  5. Click Save when finished.

Tip: Use Ctrl + Z (Cmd + Z on Mac) to undo your changes.

add-remove-tags-option

Bulk editor: available on both on the content and media pages.

tags-bulk-editor

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.


Using tags to search for content

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. 

tags-search-multiple-filters
Filter nameResult

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

Don't include

Any entries or assets without the provided tags

Any

Entries or assets that contain at least one tag

Not tagged

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:

tags-search-1-filter

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. 

search-tags-columns

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. 

Granting permission to manage tags

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:

  1. Navigate to Settings > Space settings > Roles & permissions.

  2. Find the role you’d like to grant the manage tags permission to.

  3. Click the triple-dot icon and select Edit.

  4. Select the checkbox "Can create and manage tags".

manage tags permission

Frequently asked questions (FAQ)

Can I use tags for SEO purposes?

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.

Can I use tags for enriching assets with metadata?

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. 

Can tags be used in apps?

Not yet, but stay tuned. 

Are tags a paid feature?

Tags are currently only available to a select number of customers through the Early Access Program. 

What is the maximum number of tags allowed per environment?

100

What is the maximum number of tags allowed per entry or asset?

20

Can tags be managed in a programmatic way?

Yes. If you are a space admin or have been granted the manage tags permission, you can manage tags via the Contentful Management API (CMA). See our CMA documentation for more information. You can also use tags in contentful-management.js, our JavaScript management SDK. Soon tags will be supported by our contentful-migration, contentful-import and contentful-export tools via the contentful-cli.

Was this helpful?
add-circle remove style-two-pin-marker subtract-circle