Simple List widget

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 2 minutes to read

    • The Simple List widget can be used to display any list in the system within Service Portal. You can use this base system widget as-is in your portal or clone it to suit your own business needs.

    Figure 1. Simple List widget
    Simple List widget

    Instance options

    Table 1. Instance options fields
    Field Description
    Table The platform table that the simple list is formed from.
    Filter Conditions that are applied to the list. To edit the filter, in the widget instance options context menu, select Open in platform. Use the Table & Filter tab to apply conditions to the simple list. For more information, see Create a filter in List.
    Display field Main field that displays as the "title" of the list item.
    Secondary fields Fields from the list item that display in addition to the main display field.
    List page The page that opens when a user selects View all in the widget footer. Select a page that correlates with the items that display in the list.
    Enforce field-level Read ACLs on Filter query terms (may alter the query for unprivileged users) Enforce read ACL rules for fields included in filter conditions applied to the list.
    Note:
    When the glide.service_portal.enable_acls_for_encoded_query_in_list system property is set to true, read ACLs are enforced for Simple List filter conditions always.
    Link to this page Portal page to link to from a list item.
    Show even when empty Widgets are designed to hide on a page when no results meet the criteria. Select this option to make the simple list widget display on a page even when empty.
    View The view option for when a list item links to a form. The Link to this page field must be set to a form page for this option to work.
    Disable record watcher Turn off automatically updating the list based on changes to the filtered records.
    Glyph Icon that displays next to the widget name in the header
    Bootstrap color Color scheme for the widget. The default colors are defined by the portal theme, but if you want the instance to have a specific color, select the option from the list.
    Bootstrap size Size of the widget
    Maximum entries Maximum allowed number of entries that appear in the list at one time.
    List body height Actual length of the widget in pixels or EMs. A long list with a small body height includes a scroll bar option.
    Image field Displays an image in the list. Select a field type that includes an image. For example, Photo.
    Rounded images Makes any images selected in the Image field round in the list.
    Hide footer Show or hide the widget footer