---
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/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/add-conf-port-taxo-topic.html
release: australia
product: Customer Self-service and Omnichannel Engagement
classification: customer-self-service-and-omnichannel-engagement
topic_type: task
last_updated: "2026-03-12"
reading_time_minutes: 1
breadcrumb: [Portal Taxonomy Topic widget, Configurable Portal widgets, Set up self-service, Configure, Customer Service Management]
---

# Add and configure the Portal Taxonomy Topic widget

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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/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/australia/markdown/australia/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** > **Service Portal** > **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/australia/markdown/australia/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/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/map-browse-taxo-with-taxo-topic.md)