Related articles

Related articles are links to other articles in your knowledge base that appear at the bottom of an article on the knowledge base site. They are selected by the article author and help readers navigate to content that is relevant to what they have just read.

When to use related articles

• Add related articles to guide readers to the next logical step after completing an article, for example, linking a "Getting started" article to a "Configuration" article.
• Use related articles to surface prerequisite content readers may have missed.
• Use Eddy AI recommendations to quickly populate related articles for new or recently updated content without manually searching.

Add related articles

There are two ways to add related articles: manually by searching your knowledge base, or automatically using Eddy AI recommendations.

Manually

1. Navigate to Documentation () in the left navigation bar.
2. Open the article.
3. Click the More () icon in the article header and select Related articles. The Article settings panel appears on the Related articles tab.
4. Enter a keyword in the search bar to find articles.
5. Click the Add (+) icon next to the article you want to add. The article appears under Added articles.
6. To remove an article from the list, click the Remove (x) icon next to it.
7. Click Save.

You can also add related articles while publishing. Click Publish, then select Related articles from the panel list on the left side of the publish confirmation dialog and add articles there. Click Publish (or Schedule) to save and publish.

Using Eddy AI

Eddy AI analyses your article content and suggests relevant articles from your knowledge base automatically.

1. Open the Related articles tab in the Article settings panel.
2. Click Ask Eddy AI below the search bar. Suggested articles appear under Suggested articles from Eddy AI.
3. Click the Add (+) icon next to any article you want to include.
4. Click Save.

Auto relate

The Auto relate this article to all related articles toggle in the Article settings panel automatically creates a two-way link between the active article and all its related articles. When enabled, the active article appears in the related articles section of every article it is linked to.

Archived related articles

Archiving an article affects every article that lists it as a related article. Because archived content is removed from the knowledge base site, an archived article does not appear in the related articles section for readers.

• Check which articles link to an item before you archive it, particularly if you used the Auto relate toggle, which creates the relationship in both directions.
• Archived articles are also excluded from dynamic related article recommendations, so Eddy AI does not surface them to readers on the knowledge base site.
• You cannot add an archived article as a related article. Only published articles appear in the search results in the Related articles panel, and archived articles are excluded from portal search.
• When you unarchive the article, it returns with its previous status. A Published article becomes available on the knowledge base site again and reappears in the related articles section.

Best practices

• Limit related articles to three to five per article. Too many links reduce the value of each recommendation.
• Link to articles that are directly relevant to the reader's next action, not just broadly related topics.
• Use the Auto relate toggle when adding related articles to ensure the relationship is visible from both articles, not just one.
• Review related article links when restructuring your knowledge base. Moved, archived, or deleted articles may leave broken references in the related articles list.
• Check the related articles list before archiving. The archive confirmation dialog flags related articles as an affected area, so confirm which articles point to the one you are retiring.

FAQ