Using labels on your Help Center articles (Guide Professional)

Labels are a single word or a multiple word phrase you can add to the default language version of a specific article in Help Center. You can use labels to influence article search relevance, to influence Answer Bot results (if you are using Answer Bot), or to create a list of related articles based on labels.

This article contains the following sections:

• Understanding why to use labels
• Adding labels to articles
• Best practices for adding labels
• Using the Help Center API to filter articles by labels

Understanding why to use labels

Labels have the following uses and impacts:

• Influence article search relevance

  Adding labels can make your articles more search friendly. They are not designed to be used for fine-grained control of ranking. For example, if I have two articles about making waffles, one with the word "temperature" in the body of the article, one with the label "temperature", the labeled article will be ranked higher if a user searches for the word "temperature".

  Labels are indexed for search with a bit less weight than the article title, but multiple labels with similar words can outweigh the title and body of the article. Use labels carefully as you can significantly impact the relevance of your search results and usefulness. If you are considering using labels to impact search relevance, consider that efforts to do so could end up with inferior ranking performance for your users. The best way to have your article perform well in search is to create a short and focused article, where the title and body include keywords and clearly connect to each other.

  To learn more about search, see How end-user search works in Help Center.

• Influence Answer Bot results

  Answer Bot uses labels to influence the results it shows. It allows you to define a whitelist of articles that are allowed to be used when looking for relevant matching results. You are able to add up to ten labels that serve as an OR filter, allowing you to expand the whitelist to any articles containing any of the defined labels.

  To learn more about Answer Bot, see About Answer Bot.

• Create article lists

  Article lists enable you to get an overview of all your published and unpublished knowledge base content, and then refine that view by using search and applying filters to build article lists. For example, you can find articles that have a specific article label, such as out-of-date.

  To learn more about article lists, see Creating article lists to different views of your knowledge base content.

Adding labels to articles

Labels are a single word or a multiple word phrase you can add to the default language version of a specific article in Help Center.

To add labels to an article

1. In Help Center, create a new article or edit an existing article.
2. In Labels in the right sidebar, enter the label you'd like to add, then select Add as new label or select the matching label, if it exists.

   See Best practices for adding labels.

   

   Labels live on the default language article and not on translations of the article. If you have translations, you can add labels in multiple languages to the default article.

3. Add multiple labels as needed.
4. Click Update.

You must manage labels on each individual article or using the API. There is no global management for article labels.

Best practices for adding labels

Labels can help boost the search relevance of an article. However, you should use labels carefully and sparingly. It's more important to make sure the article title and body contain the relevant keywords. 

• Use single word labels where possible, instead of multi-word phrases

  It is possible to add labels as single words or as multiple words or phrases. In general, it's better to use single word labels, unless you have a phrase that carries a specific meaning for the words together. For example, "Help Center" has a specific meaning, where "Help" and "Center" have different meanings separately.

  Avoid using long phrases as labels to boost an article's ranking with respect to a query. For example, "Can I return something I ordered online to my local store." Instead, you should modify the article's title or content to make it literally relevant to the query.

• Do not include variations of the same word, including different tenses or plural forms

  You do not need to include multiple labels for variations of a word. For example you do not need a label for "return" and "returns" or "update" and "updated." Search stemming allows different forms of the same word to match. In particular, the singular and plural forms of a word will generally match.

• Use a limited number of labels, instead of overloading an article with labels

  Use labels sparingly. Adding lots of labels might actually diminish any matches on labels. This is because it is assumed that matches with a fewer number of labels beats matches with more labels. And too many labels might outweigh the relevance of the title and body.

  Your best bet is to look at the top ranked search queries and make sure that they exist in either (but not both) the title or the labels. You don't give content an extra boost if you match a term across the title, body, labels, and comments.

Using the Help Center API to filter articles by labels

There are two ways you can filter articles by labels using the Help Center API:

• Article: /api/v2/help_center/en-us/articles.json?label_names=foo​
• Search: /api/v2/help_center/en-us/articles/search.json?label_names=foo

These two endpoints behave differently and will return different article results. They are programmatically different and query different data sources for their results. Learn more