About content tags

Content tags are words or short phrases that you can add to articles or community posts to group and 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 or to manage existing content tags. You cannot add content tags in bulk.

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 collections 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 for that content collection. They can click the links within each collection to quickly find the information they need in your help center, regardless of where the content 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.

This article includes the following sections:

• What are content tags and how are they used?
• Getting started with content tags
• Best practices for using 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.

To get started with content tags

1. (If necessary) Download the latest Copenhagen theme or update your custom theme to enable content tags. Content tags are available by default in standard themes and themes that were customized after October 19, 2022. If your help center was created before October 19, 2022 and uses a customized theme, you need to update your custom theme to use content tags.
2. 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.
3. 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.

When you are ready to begin using content tags, see these articles for more information about how to create and use content tags in your articles and posts.

• Creating content tags for content collections
• Managing content tags
• Viewing content tags
• Adding content tags to 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.
• Merging content tags: Resolve errors in tag names or remove duplicate tags by merging content tags. For example, if you have two content tags named "content tag" and "content_tag", you can merge the incorrect tag into the correct tag. When you merge a tag, content associated with the merged tag is added to the tag you are merging into. The merged tag is then deleted from your account. See Managing content tags.