Display widgets on records and tables forms to gain more functionality or for any other purpose.

To add a widget to a form, follow the steps below:

  1. Configure widget displayability before adding it to layout.
  2. Configure the options schema.

After all preparations are done, you can add a widget to a form. For this, please complete the steps below:

  1. Open the form you want to add a widget to.
  2. In the hamburger menu, select Configure → Form → Layout.
  3. Add a widget to form layout.
  4. Click Save to apply changes.

Configure a widget


Firstly, you need to configure a specified widget to make it available for adding. For this, please follow instructions provided in the Widgets Displaying article.

Add a widget to a form layout


On the form appeared, select a widget you want to add:

  1. Click on a desired widget from the Available box.
  2. Drag-and-drop or use form buttons to move the widget to the Selected box.


  3. Define a widget position on the form with or  buttons. Use splitter elements to create the form structure. You can also drag-and-drop items between heapselect fields, and within a single field, instead of using buttons.

    See Form Layout to learn more about form layout configuration.

Configure the options schema


Use the Widget Instance window to specify the widget options. Click on the widget while configuring the layout to call this window.

See Portal widget option to learn more about widget configuring when adding a widget to a page or to a form.

To configure the widget options schema, follow the steps below:
  1. In the Schema Option Values field, enter the widget options in JSON format.
  2. Specify the desired widget option values, otherwise, the default values will be applied:

    JSON Example
    {
        "tableName": "itsm_incident",
        "condition": "state!=10"
    }


    The widget of each type has the following common Attributes along with the set of private attributes specified.

    See Portal SimpleTags and Box widgets to learn more.

  3. Click Save to apply the changes and leave the form configuration view.


  • No labels