Tags

NOTE: For all other uses regarding organizing and searchability of content, we advise using our new Taxonomy feature.

Tags are assigned to entries and assets on an environment level. They help users to organize and search for the content within the web app.

Tags are especially helpful if you have multipleUsers and teams of contributors working together within one space. Tags can help editors quickly and easily identify which content is most relevant for them.

Tags visibility

According to their visibility, tags are divided into two types: private and public. Private tags can only be viewed by users with relevant permissions. Public tags are visible in an environment, as well, but they can also be returned to your client-side apps via the Content Delivery API. This is especially useful if you want to group content no matter the content type and query for these grouped entries or assets from your applications.

Use private tags for organizing content within the web app or public tags for organizing content in your applications. By default, tags are always private.

Who can create tags?

By default, tags can be created by users in admin roles. However, you can decide which roles can create tags by updating Space roles in the Settings of your space.

What is the maximum number of tags allowed per environment?

1000

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

100

Can I edit my tags?

Tag IDs are immutable and cannot be modified after the tags are created to preserve the metadata associated with your entries. However, the tag name can be easily modified by visiting the tag section in your environment settings. Once applied, changes to the tag name will be immediately reflected in your environment. Keep in mind that tags have to carry unique names and IDs.

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 client library, as well as our contentful-migration, contentful-import and contentful-export tools via the contentful-cli.

What is the difference between private and public tags?

Private tags are meant to be used solely by internal teams and are only accessible via the Content Management API (CMA). By contrast, public tags can be used in customer-facing context, for example, to display SEO-related metadata, streamline the organization of public content or supporting various personalization scenarios on the frontend. For this reason, public tags are accessible via the CMA, Content Delivery API (CDA) and Content Preview API (CPA). Please note that tags can be set to private/public only during the creation process.

Are tags environment-aware?

Yes, tags are environment-aware. This means that you can define a distinct set of tags for each of the environments you are working in. This is useful when developing new features or preparing large content updates.

Can I use tags in search?

Yes, our search functionality supports tags in the web app and within our APIs. Our tests also show that searching for content using tags tends to produce faster results. For this reason, we actively encourage our users to use tags for filtering content whenever possible.

Can I use tags for SEO purposes?

Public tags can be used for SEO purposes because they are exposed through the Delivery API to your client-side applications.

Private tags cannot be used for SEO. They are intended to be used to organize and search for content within Contentful, and they are only returned in the Contentful Management API.

Can I use tags for enriching assets with metadata?

Yes, you can add tags to assets to store metadata. Only public tags will be returned in the Contentful Delivery API, whereas private tags are only returned in the Contentful Management API. 

Can tags be used in apps?

Yes, you can create, read, update and delete tags via apps.

Are tags a paid feature?

No, tags are available to all customers on the current plans.