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.
[Omitted image "WidgetSimpleList.png"] Alt text: Simple List widget
Instance options
|
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 |
Related topics
--- title: Simple List widget description: 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. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/platform-user-interface/service-portal/simple-list-widget.html release: australia product: Service Portal classification: service-portal topic_type: concept last_updated: "2026-09-10" reading_time_minutes: 2 breadcrumb: [Example widgets, Widget library, Using portal widgets, Configuring Service Portal, Service Portal, Configure UIs and portals, Configure user experiences] --- # 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. \[Omitted image "WidgetSimpleList.png"\] Alt text: Simple List widget ## Instance options <table id="table_lgf_x32_k1b"><thead><tr><th> Field </th><th> Description </th></tr></thead><tbody><tr><td> Table </td><td> The platform table that the simple list is formed from. </td></tr><tr><td> Filter </td><td> 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/t_CreatingFilters.md). </td></tr><tr><td> Display field </td><td> Main field that displays as the "title" of the list item. </td></tr><tr><td> Secondary fields </td><td> Fields from the list item that display in addition to the main display field. </td></tr><tr><td> List page </td><td> 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. </td></tr><tr><td> Enforce field-level Read ACLs on Filter query terms \(may alter the query for unprivileged users\) </td><td> 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. </td></tr><tr><td> Link to this page </td><td> Portal page to link to from a list item. </td></tr><tr><td> Show even when empty </td><td> 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. </td></tr><tr><td> View </td><td> 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. </td></tr><tr><td> Disable record watcher </td><td> Turn off automatically updating the list based on changes to the filtered records. </td></tr><tr><td> Glyph </td><td> Icon that displays next to the widget name in the header </td></tr><tr><td> Bootstrap color </td><td> 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. </td></tr><tr><td> Bootstrap size </td><td> Size of the widget </td></tr><tr><td> Maximum entries </td><td> Maximum allowed number of entries that appear in the list at one time. </td></tr><tr><td> List body height </td><td> Actual length of the widget in pixels or EMs. A long list with a small body height includes a scroll bar option. </td></tr><tr><td> Image field </td><td> Displays an image in the list. Select a field type that includes an image. For example, Photo. </td></tr><tr><td> Rounded images </td><td> Makes any images selected in the Image field round in the list. </td></tr><tr><td> Hide footer </td><td> Show or hide the widget footer </td></tr></tbody> </table>**Parent Topic:**[Example widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sp-example-widgets.md) **Related topics** [Create and edit a page using the Service Portal Designer]() [Configure widget instances]() [Clone a widget]()
| title | Simple List widget |
| description | 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. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/platform-user-interface/service-portal/simple-list-widget.html |
| release | australia |
| product | Service Portal |
| classification | service-portal |
| topic_type | concept |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | Example widgetsWidget libraryUsing portal widgetsConfiguring Service PortalService PortalConfigure UIs and portalsConfigure user experiences |