Content tags are words or short phrases that you can add to articles or community posts to connect different types of content, making it easy for your users to quickly find related content across their help centers. You can use article settings to add content tags to individual articles, or you can use the central content tag management page to create and add content tags to articles. You cannot add content tags in bulk at this time.
Unlike labels, which improve search relevance and are used as search keywords, content tags are not searchable nor do they boost search relevance. Instead, content tags let content authors manually create groupings of related content across different sections, topics, and content types. End users can click the content tag displayed on an article or post to open a search page with links to related content, making it easy for them to quickly find the information they need in your help center, no matter what type of content it is or where it sits in your content hierarchy.
Before you can use content tags, you must download the latest Copenhagen theme or update your custom theme to enable content tags. See Getting started with content tags.
What are content tags and how are they used?
Content tags are descriptive terms that you can assign to articles and posts to group them by a common attribute. When you add a content tag to an article or community post, that tag appears in the Related to section at the bottom of the article or post. Users can click the tag to view a search page displaying all other content in your help center with the same tag.
For example, this image shows an article with three assigned tags: federated search, API, and search crawler.
When the article is published, the content tags appear as clickable links under the Related to section of the article.
Users can click the content tags to open a search results page that shows all help center content with the same tag.
Getting started with content tags
If you have never used content tags before, here are some considerations and possible theme updates to make before you begin.
- Ensure you have the Guide and Gather plans that support this feature.To use content tags with articles, you must have a Guide Professional plan or higher. To use content tags with community posts, you must have a Gather Professional plan or higher.
- Download the latest Copenhagen theme or update your custom theme to enable content tags, if necessary. If you are using a theme customized before October 19, 2022, you need to add code to your custom theme to enable content tags before you can add them to your help center. Content tags are available by default in standard themes and themes that were customized after October 19, 2022. If this step applies to you, see Adding content tags to articles and posts.
- Enable content tagging for your community. By default, content tagging on community posts is disabled, meaning that end users cannot add content tags to their posts. If content tags have been applied to posts or articles, end users will still be able to see and click those tags on published content, but they cannot add them. When content tagging on community posts is enabled, end users can view and apply any content tag in your application to their community post. Before you enable content tags on your community content, make sure that you approve of all community users viewing and using the content tags you define. To allow end users to apply content tags to posts see Allowing users to add content tags to community posts.
- Understand who has permission to create, add, and remove content tags. Guide admins and article authors can create content tags in articles. Only Guide admins and agents can create content tags in community posts.
Best practices for using content tags
The following best practices explain how to make the most out of using content tags to streamline your end user experience:
- Naming - When you write an article or post, try to think about what main ideas, concepts, features, or products it covers. Content tags are intended to simplify search, so when you create a tag, ask yourself if this name can be understood and reused by others. It also helps to use short names. Content tags are case insensitive so if you have a content tag titled “test” then you cannot call a new tag “TEST”.
- Limit content tags: Although it is possible to add up to 25 tags to an article or post, you should only use 5 to 7 content tags. The purpose of content tags is to surface related content across your help center and community. If you place too many content tags on an article or post, it will be cluttered and difficult to use.
- Keep tags current: Review content tags once in a while, look for spelling and grammar mistakes, duplication, and low usage. You can easily fix mistakes by updating the name of a tag. For tags with low usage, it is important to check if a name is meaningful and understood by others. In this case, consider renaming or even removing a content tag.