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

  1. Navigate to All > Service Portal > 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 (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.

Example: Configure widget instance options

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.