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

Simple List widget

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.

Image omitted: WidgetSimpleList.png
Simple List widget

Instance options

FieldDescription
TableThe platform table that the simple list is formed from.
FilterConditions 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 fieldMain field that displays as the "title" of the list item.
Secondary fieldsFields from the list item that display in addition to the main display field.
List pageThe 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 pagePortal page to link to from a list item.
Show even when emptyWidgets 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.
ViewThe 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 watcherTurn off automatically updating the list based on changes to the filtered records.
GlyphIcon that displays next to the widget name in the header
Bootstrap colorColor 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 sizeSize of the widget
Maximum entriesMaximum allowed number of entries that appear in the list at one time.
List body heightActual length of the widget in pixels or EMs. A long list with a small body height includes a scroll bar option.
Image fieldDisplays an image in the list. Select a field type that includes an image. For example, Photo.
Rounded imagesMakes any images selected in the Image field round in the list.
Hide footerShow or hide the widget footer

Parent Topic:Example widgets

Related topics

Create and edit a page using the Service Portal Designer

Configure widget instances

Clone a widget