{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":42598,"path":"platform-user-interface/service-portal/simple-list-widget.md","title":"Simple List widget","bundle":null,"doc_type":null,"release":"australia","body":"\n# Simple List widget\n\nThe 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.\n\n\\[Omitted image \"WidgetSimpleList.png\"\\] Alt text: Simple List widget\n\n## Instance options\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nTable\n\n\n\nThe platform table that the simple list is formed from.\n\n
\n\nFilter\n\n\n\nConditions 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).\n\n
\n\nDisplay field\n\n\n\nMain field that displays as the \"title\" of the list item.\n\n
\n\nSecondary fields\n\n\n\nFields from the list item that display in addition to the main display field.\n\n
\n\nList page\n\n\n\nThe 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.\n\n
\n\nEnforce field-level Read ACLs on Filter query terms \\(may alter the query for unprivileged users\\)\n\n\n\nEnforce 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.\n\n
\n\nLink to this page\n\n\n\nPortal page to link to from a list item.\n\n
\n\nShow even when empty\n\n\n\nWidgets 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.\n\n
\n\nView\n\n\n\nThe 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.\n\n
\n\nDisable record watcher\n\n\n\nTurn off automatically updating the list based on changes to the filtered records.\n\n
\n\nGlyph\n\n\n\nIcon that displays next to the widget name in the header\n\n
\n\nBootstrap color\n\n\n\nColor 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.\n\n
\n\nBootstrap size\n\n\n\nSize of the widget\n\n
\n\nMaximum entries\n\n\n\nMaximum allowed number of entries that appear in the list at one time.\n\n
\n\nList body height\n\n\n\nActual length of the widget in pixels or EMs. A long list with a small body height includes a scroll bar option.\n\n
\n\nImage field\n\n\n\nDisplays an image in the list. Select a field type that includes an image. For example, Photo.\n\n
\n\nRounded images\n\n\n\nMakes any images selected in the Image field round in the list.\n\n
\n\nHide footer\n\n\n\nShow or hide the widget footer\n\n
**Parent Topic:**[Example widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sp-example-widgets.md)\n\n**Related topics** \n\n\n[Create and edit a page using the Service Portal Designer]()\n\n[Configure widget instances]()\n\n[Clone a widget]()\n\n"}}