Mark as deprecated

Plans supporting mark as deprecated

Professional
Business
Enterprise






What is a deprecated article?

In the context of a knowledge base, a deprecated article is flagged as obsolete and may no longer be relevant or valuable for the reader. It is usually replaced by more up-to-date information. Articles may be marked as deprecated for various reasons, such as the core subject being removed, no longer in use, modified, or replaced with a different concept.

For instance, if a product feature is removed or significantly changed, you can mark the related article as deprecated. This helps readers avoid outdated information and redirects them to updated resources or newer articles.

Mark as deprecated

Previously, the Mark as deprecated option was available at the workspace level. Now, this feature is available at the article or page category level, where the article will display a Deprecated status tag. Additionally, you can provide a custom deprecation message explaining the reason for deprecation and include hyperlinks to any alternate or updated versions of the article/page if applicable.


Marking an article as deprecated

  1. Navigate to the article (published or unpublished) in the Knowledge base portal.

  2. Click the More (•••) icon and select More article options.

  3. In the Article settings panel, select the Mark as deprecated tab.

  4. Turn on the Deprecated toggle.

  5. Enter the reason for deprecating the article in the text field. This message is optional and will be displayed on the Knowledge base site.

  6. Use basic text formatting options like Bold (), Italics (), and Underline (), or add Hyperlinks () if needed.

  7. Once done, click Save.


Marking multiple articles as deprecated

To mark multiple articles as deprecated in one instance, follow the steps below:

  1. Navigate to the Documentation () and select All articles in the Knowledge base portal.

    A list of all articles will appear in the All articles page.

  2. Select the articles you want to mark as deprecated.

  3. Click the More (•••) icon and select Deprecate.

    By default, the Deprecate toggle will be enabled.

  4. Enter the Deprecation message in the text field.

  5. Once done, click Apply.


Knowledge base site view

In the Knowledge base site, a deprecated article will display a Deprecated tag and a message at the top in a highlighted format with this icon - .