---
sourceDocument: Yokohama Customer Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/customer-service-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Customer Service Management

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# Add a widget in the Portal Banner widget

# Add a widget in the Portal Banner widget {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Add a widget for additional functionality to the Portal Banner widget and configure it. For example, you could add the Portal Quick Links widget to enable users to
access knowledge articles, external URLs, catalog items, or custom pages from the Portal Banner widget.

## Before you begin

The UI Components for Customer Portals plugin must be installed. For more information, see [Activate the UI Components for Customer Portals plugin](https://www.servicenow.com/docs/v7bv~pJALHb4tWCJ3nwzEQ "You can activate the UI Components for Customer Portals plugin (sn_ciwf_ui_cmpnt) to enable Configurable Portal widgets. The application installs related plugins if they aren’t already installed.").

Role required: admin or sp_admin

## Procedure

1. Navigate to your portal home page.
2. On the widget you want to add, press Control+right-click.
3. In the context menu, select Instance in Page Editor.
4. In the Edit section, select the Portal Quick Links widget from the flowchart.  
   The Portal Quick Links widget has been considered as an example.
5. Select the Instance 2.
6. Copy the JSON code from the Additional options, JSON format field.
7. On your portal home page, press Control+right-click on the Portal Banner widget..
8. Select Instance Options.
9. In the Behavior section, paste the JSON code into the Widget Option Schema field.
10. In the Widget Option Schema field, modify the JSON code to update the configuration of the widget that you've added.  
    For more information on each JSON parameters of the Portal Quick Links widget, see [Portal Banner widget JSON parameters](https://www.servicenow.com/docs/Nju0iZx8Z2_MhH~_UOUdCQ "JSON parameters define aspects of the Portal Quick Links widget on the Portal Banner widget.").
11. Select Save.