Configure widget instances

task brazil Updated Sep 10, 2026 2 min read c_ConfigureWidgetInstances.md

Create unique instances of widgets by configuring the options for each instance.

Before you begin

Create or edit a portal page and add widgets to it. You can also configure the existing widget instances on a base system page. For more information, see Create and edit a page using the Service Portal Designer.

Role required: sp_admin or admin

About this task

You can have several instances of the same widget on a page, and each instance of the widget you configure remains unique. For example, each instance of the Cool Clock widget on a page could use a different time zone.

Each time you add a widget to a page it creates a record on the Widget Instances [sp_instance] table with the following information:

A reference to the widget
A reference to the column of the page where the widget is located
The configuration for a widget in the form of pre-defined form fields and an Additional Options field in JSON format

Note: For widgets that do not contain any information by default, you must configure the options for their widget instances before they will appear on a portal page.

Procedure

Navigate to All > Service Portal > Service Portal Configuration.
Select Designer.
Select the page with the widget instance(s) you want to configure.
In the Service Portal Designer, move to a widget instance and select the Edit icon ([Omitted image "WidgetEditIcon.png"] Alt text: Edit icon).
In the instance options window, fill in the fields to configure the widget instance.

Instance options vary depending on which widget you select.
Select Save.

[Omitted image "WidgetInstanceOptions.gif"] Alt text: Gif showing how to access widget instance options from the Service Portal Designer

What to do next

Advanced users can define what options are available for a widget. For more information, see Widget option schema.

Parent Topic:Using portal widgets

64 lines · 3.1 KB Wrap lines

---
title: Configure widget instances
description: Create unique instances of widgets by configuring the options for each instance.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/platform-user-interface/service-portal/c\_ConfigureWidgetInstances.html
release: brazil
product: Service Portal
classification: service-portal
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Using portal widgets, Configuring Service Portal, Service Portal, Configure UIs and portals, Configure user experiences]
---

# Configure widget instances

Create unique instances of widgets by configuring the options for each instance.

## Before you begin

Create or edit a portal page and add widgets to it. You can also configure the existing widget instances on a base system page. For more information, see [Create and edit a page using the Service Portal Designer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-user-interface/service-portal/t_ConfigureAPage.md).

Role required: sp\_admin or admin

## About this task

You can have several instances of the same widget on a page, and each instance of the widget you configure remains unique. For example, each instance of the [Cool Clock widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-user-interface/service-portal/cool-clock-widget.md) on a page could use a different time zone.

Each time you add a widget to a page it creates a record on the Widget Instances \[sp\_instance\] table with the following information:

- A reference to the widget
- A reference to the column of the page where the widget is located
- The configuration for a widget in the form of pre-defined form fields and an **Additional Options** field in JSON format

**Note:** For widgets that do not contain any information by default, you must configure the options for their widget instances before they will appear on a portal page.

## Procedure

1. Navigate to **All** &gt; **Service Portal** &gt; **Service Portal Configuration**.

2. Select **Designer**.

3. Select the page with the widget instance\(s\) you want to configure.

4. In the Service Portal Designer, move to a widget instance and select the Edit icon \(\[Omitted image "WidgetEditIcon.png"\] Alt text: Edit icon\).

5. In the instance options window, fill in the fields to configure the widget instance.

Instance options vary depending on which widget you select.

6. Select **Save**.

## Configure widget instance options

\[Omitted image "WidgetInstanceOptions.gif"\] Alt text: Gif showing how to access widget instance options from the Service Portal Designer

## What to do next

Advanced users can define what options are available for a widget. For more information, see [Widget option schema](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-user-interface/service-portal/c_WidgetInstanceOptions.md).

**Parent Topic:**[Using portal widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-user-interface/service-portal/service-portal-widgets.md)