Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Map a related item in Agent Workspace

Manually map catalog items related to a knowledge article in Agent Workspace to enable employees to request the related catalog item.

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

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

Procedure

  1. Navigate to All > Agent Workspace > Agent Workspace Home.

  2. Go to Lists > Knowledge > Published for a published article or Lists > Knowledge > Unpublished for an unpublished article.

  3. Click the link to the knowledge article for which you want to map a related item.

  4. On the Knowledge form, click the Related Catalog Items related list.

  5. Click New.

  6. On the Related Catalog Items form, fill in the fields.

FieldDescription
ActiveOption to enable the mapping to the related catalog item.
Catalog itemCatalog item related to the knowledge article.You can click the search for record icon to access a list of available catalog items.
Knowledge articleNumber of the knowledge article for which you are adding the related catalog item.
OrderOrder in which you want the catalog item to appear in the Related Items section on the Knowledge Management article view page. A lower value means that a catalog item has the greater priority to appear in the Related Items section. The default value is 100.
  1. Click Save.

Result

The mapped catalog items are listed in the Related Items section on the Knowledge Management article view page in Knowledge Management Service Portal.

Note: Because system administrators can configure the number of catalog items shown in the Related Items section, not all mapped related catalog items might appear in the Related Items section. For more information, see Configure related catalog item widget instance options.

Related topics

Edit a knowledge article in Agent Workspace

Service Catalog items