Create a custom knowledge homepage

  • Release version: Yokohama
  • Updated January 30, 2025
  • 1 minute to read

    • As a system administrator, you can create a module allowing users to open a knowledge homepage for a specific knowledge base or category.

    Before you begin

    Role required: admin

    About this task

    Note:
    This topic creates a legacy v3 knowledge homepage. You can create a portal homepage and configure it to get a new look and feel. For information, see Configure the Knowledge Management Service Portal.

    Procedure

    1. In the application navigator, point to the application name and click the edit application icon (Edit Application icon).
    2. In the Modules related list click New.
    3. Enter a Title for the module.
    4. In the Link type field, select URL (from Arguments).
    5. In the Arguments field, append one or more of the following values to $knowledge.do#/search?.
      OptionDescription
      sysparm_kb=<knowledge base sys_id>

      Enter the sys_id of a knowledge base to show knowledge articles from that knowledge base by default.

      If the specified knowledge base does not exist, the default knowledge homepage appears when accessing the custom homepage module.
      sysparm_category=<knowledge category sys_id>

      Enter the sys_id of a knowledge category to show knowledge articles from that category by default.

      If the specified category does not exist, the default category for the selected knowledge base appears when accessing the custom homepage module.
      Note:
      The category passed in this parameter must belong to the knowledge base passed in the sysparm_kb parameter.
      sysparm_order=<view_count, last_modified, or relevancy>

      Enter the default sort order for articles to appear in.

    Example

    To create a homepage for a Facilities knowledge base with a sys_id of d582764047022100158b949b6c9a7145 and sorting by last modified date, enter $knowledge.do#/search?sysparm_kb=d582764047022100158b949b6c9a7145&sysparm_order=last_modified in the Arguments field on the Module form.