Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Add and configure the Portal Banner widget

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

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

About this task

[Omitted video] Description: Configure portal banner widget

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. Add container.

    1. Select the Widgets tab.

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

    3. On the container, select the Pencil icon (

Image omitted: icon-pencil-ac.png
Pencil icon\).
4.  In the **Width** field, select **Fluid**.

5.  Select **Save**.
  1. Add columns to container.

    1. On the container, add a set of columns by selecting the plus button (
Image omitted: portal-plus-icon.png
Plus button\).
2.  In the column, select the Edit page properties icon \(
Image omitted: icon-portal-page.png
Edit page properties icon.\).
    **Note:** Verify that **Column** is selected in the breadcrumbs navigation.
Image omitted: portal-banner-widget-breadcrumbs.jpg
Service Portal Designer banner displaying the Column breadcrumb
3.  Select the Edit page properties icon \(
Image omitted: icon-portal-page.png
Edit page properties icon.\) in the banner in Service Portal Designer.
4.  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.

5.  Select **Save**.
  1. Add portal banner widget.

    1. On the Widgets pane, in the Filter Widget field, enter Portal Banner.

    2. Drag the widget onto the container.

    3. In the Edit page, select the Portal Banner widget.

    4. Select the Pencil icon (

Image omitted: icon-pencil-ac.png
Pencil icon\).
5.  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](../json-param-search-option-banner-widget.md).

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

    For a description of the field values, see [Portal Banner widget instance options form](../banner-widget-inst-options.md).

7.  Select **Save**.