Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Configuring a taxonomy

Updated on September 14, 2021

A taxonomy allows you to classify or group similar content to better organize your knowledge base and support a more efficient search and display of content. Pega Knowledge supports a multi-level taxonomy category structure that offers flexibility in designing a classification approach to meet your business needs. A taxonomy category is associated with content during the content creation process.

Pega Knowledge Implementation Guide Pega Knowledge Implementation Guide Pega Knowledge Implementation Guide Pega Knowledge Implementation Guide

Prior to creating your taxonomy categories, consider the most logical structure that aligns with how you want to organize and classify your content. Some organizations create taxonomy categories that match their organizational structure. Before creating a taxonomy in the authoring portal, identify the categories required for the business.

Note: The Uncategorized category is a required taxonomy level that is included with Pega Knowledge and cannot be edited. It is used for the temporary movement of content from one taxonomy category to another. It is also used when a taxonomy category that contains content is deleted from the taxonomy editor. Because all content requires an associated category, when an associated category is deleted, the content is temporarily assigned to the Uncategorized category until it is assigned to another category.

This section contains the following topics:

  • Adding a new taxonomy category
  • Deleting a category
  • Editing a category

Adding a new taxonomy category

To create content or start a discussion that meets your content requirements when the existing categories are not relevant for new content, add a new category. You can view sample categories in the taxonomy, for example, Auto loans, Customer Service, Investment Options, and Retail Banking.

Before you begin: Before creating a taxonomy in the authoring portal, identify the categories required for the business. If you are adding external approvers, ensure that you configure email accounts. For more information, see Configuring email accounts.
  1. In the left navigation panel of Pega Knowledge portal, click Taxonomy.
  2. On the Taxonomy page, click Add new category.
  3. In the Category name field, enter the name of the new category.
  4. Optional: To create the new category under the respective parent or top level category, click Change , and then select a parent category.
    If you do not select the parent category, then the new category is created as a parent category.
  5. Optional: To add security content visibility setting to a category, select the appropriate Authorized role from the list, and then click Add.
    You can apply multiple roles to a category. Pega Knowledge authors might not have visibility to all access roles and could require a separate operator login. For more information, see Optional: Defining security.
  6. Optional: To add a knowledge expert to approve articles that are associated with this category:
    • To add an external approver, select the Is approver external check box, and then add the external email address in the External approver email field.
      Note: If you choose the knowledge expert as external approver, you need to configure the service level agreement (SLA). The service level agreement defines intervals of time, such as a goal and deadline. By using service-level agreements, you can standardize the way that external approvers can either approve or reject the articles.
    An email notification is sent to an external approver email address with the article link for review. This article link can be accessed for one time only.
    • To add an internal approver, from the Category knowledge expert list, select the approver.
    • To assign the selected knowledge expert as an approver for all associated child categories, select the Apply knowledge expert to all associated child categories check box.
  7. To select an image to use for this category, click Choose file, and then click Upload.
    Sample category icons are provided in the Pega Distribution media in the Resource Kit directory (SampleCategoryIcons.zip). Your system administrator can unzip this file onto a shared drive or a location where you can access and upload the desired category icon.
  8. To save the new category, click Submit.
    After you delete the category, any related content is automatically assigned to the Uncategorized category. You should check the uncategorized categories in the Taxonomy page periodically to review content and assign it to the proper category.

Deleting a category

You can delete unwanted categories from the taxonomy.

  1. On the Category page, click the Delete icon for the category to delete.
  2. Click Delete.
    After you delete the category, any related content is automatically assigned to the Uncategorized category. KM Authors should check the uncategorized category in the Taxonomy page periodically to review content and assign it to the proper category.

Editing a category

You can edit the details of a particular category to change the category type, category name, authorized roles, and the category image.

  1. On the Category page, click the Edit selected category icon.
  2. To change the parent category, click Change and select the category type.
  3. Optional:  Edit the Category name.
  4. Optional: Add and delete the Authorized roles for the category.
  5. Optional: Choose an image file to upload as the icon for the category.
  6. Click Update.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us