---
title: Portal Data List widget instance options form
description: The instance options enable you to configure the Portal Data List widget on a portal page.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/customer-service-management/r-port-data-list-inst-options.html
release: australia
topic_type: reference
last_updated: "2026-03-12"
reading_time_minutes: 2
breadcrumb: [Configurable Portal widgets instance options, Configurable Portal Widgets reference, Reference, Customer Service Management]
---

# Portal Data List widget instance options form

The instance options enable you to configure the Portal Data List widget on a portal page.

<table id="table_csm_base_entities"><thead><tr><th>

Instance option

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Data

</td><td>

Defines the configuration of different categories in the navigation within the widget.

</td></tr><tr><td>

Dynamic data list

</td><td>

Option to display records dynamically based on the configuration provided in the parameter of a portal page URL. **Note:**

-   The configuration enables administrator to display records from any tables by passing following URL parameters: table, filter, sort order, view, and target view page.
-   When the **Dynamic data list** is selected, the JSON configuration in the **Data** field is not available.

</td></tr></tbody>
</table>|Instance option|Description|
|---------------|-----------|
|Categories heading|Required title for all categories. The default text is `Categories`.|

<table id="table_hsg_14z_2zb"><thead><tr><th>

Instance option

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Layout

</td><td>

Layout type of the case records and their details displayed in the widget. The available options are:

-   List view \(for both desktop and mobile\)
-   Card view \(for both desktop and mobile\)
-   List view \(for desktop\) &amp; Card view \(for mobile\)

**Note:** Currently, if you select None, the layout is set to List view \(for desktop\) &amp; Card view \(for mobile\).

The default configuration is List view \(for desktop\) &amp; Card view \(for mobile\).

</td></tr><tr><td>

Number of records per page \(Desktop\)

</td><td>

The number of cases to appear by default on the widget in the desktop. The default value is 20. The maximum value is 1000.

</td></tr><tr><td>

Number of records per page \(Mobile\)

</td><td>

The number of cases to appear by default on the widget on a mobile device. The default value is 8.

</td></tr><tr><td>

Show search

</td><td>

Option to display a search field in the widget.

</td></tr><tr><td>

Show export actions

</td><td>

Option to enable the export of records in pdf, Excel, and csv formats.

</td></tr><tr><td>

Data List Condition Script

</td><td>

Script to show or hide the data list category on the widget. For more information, see [Hide or show categories in the Data List widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/create-cond-script-datalist-widget.md).Script to modify the view on the data list widget. For details, see, [Modify view in the Data List widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/update-view-in-datalist-widget.md).

Script to filter records in the Data List widget. For details, [Filter records in the Data List widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/filter-records-in-datalist-widget.md).

The default script is **DataListCategoryConditionScript**.

</td></tr></tbody>
</table>**Related topics**  


[Portal Data List widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/portal-data-list-widget.md)

[Add and configure the Portal Data List widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/config-data-list-widget-inst-optns.md)

[Hide or show categories in the Data List widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/create-cond-script-datalist-widget.md)