---
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 and configure the Portal Banner widget

# Add and configure 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 Portal Banner widget to your portal and modify its appearance and behavior. You can use the Portal Banner widget to display announcements, new product or feature highlights, and important information on the portal
page.

## 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://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.")

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://www.servicenow.com/docs/_NpqNwlt1Hg9mWvZM~VXfw "Create a page into which you can add Configurable Portal widgets.").

Role required: sp_admin or admin

## Procedure

1. Navigate to the AllService PortalService 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, select the Pencil icon (![Pencil icon]()).
7. In the Width field, select Fluid.
8. Select Save.
9. On the container, add a set of columns by selecting the plus button (![Plus button]()).
10. In the column, select the Edit page properties icon (![Edit page properties icon.]()).  
    Note:  
    Verify that Column is selected in the breadcrumbs navigation.
11. Select the Edit page properties icon (![Edit page properties icon.]()) in the banner in Service Portal Designer.
12. On the Page window, in the Page Specific CSS field, paste the following CSS code.  

        .col-md-12{ 
             padding-left: 0;
             padding-right: 0; 
         }
        .padding-top {
             padding-top: 0;
         } 

    If a message appears about the application scope, select here to be able to edit the record.
13. Select Save.
14. On the Widgets pane, in the Filter Widget field, enter <kbd class="ph userinput">Portal Banner</kbd>.
15. Drag the widget onto the container.
16. In the Edit page, select the Portal Banner widget.
17. Select the Pencil icon (![Pencil icon]()).
18. On the Instance form, in the Presentation field, paste the following JSON code into the Search Placeholder Text field.  

        {
            "title": "enter the title",
            "size": "enter the size of search bar",
            "color": "enter color"
        }

    For more information about each parameter, see [Script parameters for the search option in the Portal Banner widget](https://www.servicenow.com/docs/XjUVj5QyCZvUUpqTsG0lAA "Description of the JSON parameters for the search option in the Portal Banner widget.").
19. On the Instance form, fill in the fields.  
    For a description of the field values, see [Portal Banner widget instance options form](https://www.servicenow.com/docs/BGbY62FXOJFVbqO4ExMugQ "Instance options enable you to configure the Portal Banner widget on a portal page.").
20. Select Save.

*[\>]: and then