Skip to main content

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

Adding a new taxonomy category

Updated on April 27, 2021

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.
  1. In the left navigation pane 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 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 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 must 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.
      Note: 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 ( 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.

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.

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. Pega Knowledge authors should check the uncategorized category in the Taxonomy page periodically to review content and assign it to the proper category.

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us