Map a related article in Agent Workspace

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read

    • Discover similar information across articles on a topic while viewing a knowledge article. You can manually map related articles or have the application automatically present related articles using machine learning (ML) algorithms.

    Before you begin

    You must have contribute access to the knowledge base that stores the knowledge article for which you want to add related articles.

    Role required: agent_workspace_user

    About this task

    If you have manually mapped related articles when editing an article in Agent Workspace, those articles are listed in the Related Articles section on the knowledge article view page in the Knowledge Management Service Portal before the related articles that are predicted thorough the Knowledge Management similarity solution.
    Note:
    An administrator can train the solution definition for Knowledge Management within the Predictive Intelligence feature to find related articles. For more information, see Train the similarity solution for Knowledge Management to find related articles.

    This task provides steps to manually map related articles when editing an article in Agent Workspace. You can also manually map related articles when editing an article from the Knowledge Management application in the ServiceNow AI Platform interface. For more information, see Map related articles.

    Procedure

    1. Navigate to All > Agent Workspace > Agent Workspace Home.
    2. Go to Lists > Knowledge > All Articles.
    3. Click the link to the knowledge article for which you want to map related articles.
    4. In the Related Articles related list, click New.
    5. On the Related Articles form, fill in the fields.
      Table 1. Related Articles form
      Field Description
      Active Option to enable the mapping to the related knowledge article.
      Related knowledge article Knowledge article that contains related information.

      You can click the search for record icon (Search for Record icon), to access the list of available knowledge articles.
      Knowledge article Number of the knowledge article for which you are adding the related knowledge article.
      Order Order in which you want the article to appear in the Related Articles section on the Knowledge Management article view page.

      A lower value means that a knowledge article has the greater priority to appear in the Related Articles section. The default value is 100.
    6. Click Save.

    Result

    The mapped articles are available in the Related Articles section on the Knowledge Management article view page in the Knowledge Management Service Portal. See Knowledge Management Service Portal article view page features.
    Note:
    Because system administrators can configure the number of knowledge articles shown in the Related Articles section, not all mapped related articles might appear in the Related Articles section. For more information, see Configure knowledge related articles widget instance options.