Add and configure the Portal Browse Taxonomy widget

task brazil Updated Sep 10, 2026 1 min read config-portal-browse-taxo-widget.md

Add the Portal Browse Taxonomy widget to your portal and modify its behavior. The widget displays taxonomy topics along with the articles and catalog items related to them.

Before you begin

The UI Components for Customer Portals plugin must have been activated. For more information, see Activate the UI Components for Customer Portals plugin.

You must have the following setup in order to add, update, and use this widget:

The page to which you want to add the widget. For more information, see Create a page for Configurable Portal widgets
A taxonomy to map your content. For more information, see Create taxonomy.
At least one taxonomy associated with your portal. For more information, see Add a taxonomy to your portal.
At least one topic associated with the taxonomy. For more information, see Create and associate topics.
Topics associated with knowledge categories and catalog categories. For more information, see Associate content categories to topics and Associate content from catalog categories to a topic.

Role required: sp_admin

Procedure

Navigate to the All > Service Portal > Service Portal Configuration.
Select Designer.
On the Service Portal Designer page, search for and select the page to which you want to add the widget.
Select the Widgets tab.
In the Layouts section, drag the Container layout onto the portal edit page.
On the Widgets pane, in the Filter Widget field, enter Portal Browse Taxonomy.
Drag the Portal Browse Taxonomy widget onto the container layout.
In the Edit page, select a Portal Browse Taxonomy widget.
Select the Pencil icon ([Omitted image "icon-pencil-ac.png"] Alt text: Pencil icon).
On the Instance form, fill in the fields.

For a description of the field values, see Portal Browse Taxonomy widget instance options form.

58 lines · 3.9 KB Wrap lines

---
title: Add and configure the Portal Browse Taxonomy widget
description: Add the Portal Browse Taxonomy widget to your portal and modify its behavior. The widget displays taxonomy topics along with the articles and catalog items related to them.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/customer-service-management/customer-self-service-and-omnichannel-engagement/config-portal-browse-taxo-widget.html
release: brazil
product: Customer Self-service and Omnichannel Engagement
classification: customer-self-service-and-omnichannel-engagement
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Portal Browse Taxonomy widget, Set up Configurable Portal widgets, Set up self-service, Configure, Customer Service Management]
---

# Add and configure the Portal Browse Taxonomy widget

Add the Portal Browse Taxonomy widget to your portal and modify its behavior. The widget displays taxonomy topics along with the articles and catalog items related to them.

## Before you begin

The UI Components for Customer Portals plugin must have been activated. For more information, see [Activate the UI Components for Customer Portals plugin](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/customer-self-service-and-omnichannel-engagement/activate-config-portal-widget.md).

You must have the following setup in order to add, update, and use this widget:

- The page to which you want to add the widget. For more information, see [Create a page for Configurable Portal widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/customer-self-service-and-omnichannel-engagement/create-page-configurable-portal-widget.md)
- A taxonomy to map your content. For more information, see [Create taxonomy](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/create-taxonomy-content.md).
- At least one taxonomy associated with your portal. For more information, see [Add a taxonomy to your portal](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/customer-self-service-and-omnichannel-engagement/add-taxo-to-portal.md).
- At least one topic associated with the taxonomy. For more information, see [Create and associate topics](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/create-topics-for-taxonomy.md).
- Topics associated with knowledge categories and catalog categories. For more information, see [Associate content categories to topics](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/associate-knowledge-categories-to-topics-in-bulk.md) and [Associate content from catalog categories to a topic](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/associate-catalog-categories-to-topics-in-bulk.md).

Role required: sp\_admin

## Procedure

1. Navigate to the **All** &gt; **Service Portal** &gt; **Service Portal Configuration**.

2. Select **Designer**.

3. On the Service Portal Designer page, search for and select the page to which you want to add the widget.

4. Select the **Widgets** tab.

5. In the Layouts section, drag the Container layout onto the portal edit page.

6. On the Widgets pane, in the **Filter Widget** field, enter `Portal Browse Taxonomy`.

7. Drag the Portal Browse Taxonomy widget onto the container layout.

8. In the Edit page, select a Portal Browse Taxonomy widget.

9. Select the Pencil icon \(\[Omitted image "icon-pencil-ac.png"\] Alt text: Pencil icon\).

10. On the Instance form, fill in the fields.

For a description of the field values, see [Portal Browse Taxonomy widget instance options form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/port-browse-taxo-widget-inst-options.md).