Add and configure the Portal Taxonomy Topic widget

task brazil Updated Sep 10, 2026 1 min read add-conf-port-taxo-topic.md

Add a Portal Taxonomy Topic widget to your portal to display topics that your users can get more information about and modify its presentation and behavior. Once a topic card is selected, users are redirected to relevant knowledge articles and catalog items configured through the Portal Browse Taxonomy widget.

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

If you have not already created the page to which you want to add the widget, see Create a page for Configurable Portal widgets.

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 container, add a set of columns by selecting the plus button ([Omitted image "portal-plus-icon.png"] Alt text: Plus button).
On the Widgets pane, in the Filter Widget field, enter Portal Taxonomy Topic.
Drag the widget onto the container.
In the Edit page, select the Portal Taxonomy Topic widget.
Enable editing the widget by selecting 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 Taxonomy Topic widget instance options form.
Select Save.

What to do next

Configure a Portal Browse Taxonomy widget to work with the Portal Taxonomy Topic widget

60 lines · 3.3 KB Wrap lines

---
title: Add and configure the Portal Taxonomy Topic widget
description: Add a Portal Taxonomy Topic widget to your portal to display topics that your users can get more information about and modify its presentation and behavior. Once a topic card is selected, users are redirected to relevant knowledge articles and catalog items configured through the Portal Browse Taxonomy widget.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/customer-service-management/customer-self-service-and-omnichannel-engagement/add-conf-port-taxo-topic.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 Taxonomy Topic widget, Set up Configurable Portal widgets, Set up self-service, Configure, Customer Service Management]
---

# Add and configure the Portal Taxonomy Topic widget

## 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)

If you have not already created the page to which you want to add the widget, 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).

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 container, add a set of columns by selecting the plus button \(\[Omitted image "portal-plus-icon.png"\] Alt text: Plus button\).

7. On the Widgets pane, in the **Filter Widget** field, enter `Portal Taxonomy Topic`.

8. Drag the widget onto the container.

9. In the Edit page, select the Portal Taxonomy Topic widget.

10. Enable editing the widget by selecting the Pencil icon \(\[Omitted image "icon-pencil-ac.png"\] Alt text: Pencil icon\).

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

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

12. Select **Save**.

## What to do next

[Configure a Portal Browse Taxonomy widget to work with the Portal Taxonomy Topic widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/customer-self-service-and-omnichannel-engagement/map-browse-taxo-with-taxo-topic.md)