--- sourceDocument: Australia Customer Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/customer-service-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia Customer Service Management ft:clusterId : - csm bundleId : - csm workflow : - Customer and Industry --- # Component properties for the Case list # Component properties for the Case list {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Component properties for the Case list The Case list component properties allow ServiceNow customers to customize the behavior and appearance of the Case list component when embedded on third-party websites. These settings help tailor the component to specific user needs by controlling which elements are visible, how cases are filtered and displayed, and how users interact with the list. Show full answer Show less ## Key Features * **Header Customization:** Options to hide or show the header, including sub-elements like the record count, search button, filter button, refresh button, and last refreshed text. * **Data Source Configuration:** Specify the table from which cases or tasks are retrieved, defaulting to the Case \[sncustomerservicecase\] table but supporting any extended case or task tables. * **Filtering and Querying:** Use encoded queries to filter cases displayed in the list. If no query is provided, all cases are shown by default. * **Display Settings:** Choose a predefined view style or customize which columns appear in the case list. Column resizing can be enabled or disabled to control the layout. * **Pagination and Error Handling:** Set the number of records shown per page (default 20) and decide whether to hide error messages from end users on the third-party site. * **Empty State Handling:** Option to hide the component entirely if no cases are available when the component initially loads, helping to maintain clean UI presentations. ## Practical Application By configuring these properties, ServiceNow customers can ensure the Case list component integrates seamlessly with their external websites, providing users with a clear, functional, and user-friendly experience. This includes controlling visibility of UI elements, tailoring data views to specific business needs, and managing user interactions such as searching and filtering cases. Proper use of these properties enables efficient case management display and helps avoid errors, such as issues caused by reference columns in custom views. Customers can enhance their external portals with precise control over case presentation and user experience. Component properties enable you to configure the behavior of the Case list component instance on a third-party website. {#component-properties-for-the-case-list__table_csm_base_entities__entry__2} | Component property | Description | |-|-| | Hide header | Option to display header and its components. By default, it shows header. | | Title | Required title of the Case list component. | | Hide record count | Option switch to show or hide the total number of records on the case list. By default, it shows record count. | | Hide search | Option switch to show or hide search button on the header. Use the Hide search option to search the case within the case list. By default, it shows search button. | | Show filters | Option to show or hide filter button on the header. Use this option to customize the display of cases according to pre-defined filters. By default, it hides filter button. | | Hide refresh | Option to show or hide the refresh button the header. Use this option to refresh the case list. By default, it shows a refresh button. | | Hide last refreshed text | Option to show or hide a message on the header. Use this option to indicate when the last refresh occurred. By default, it shows last refreshed text. | | Table | Table from which the cases or tasks shown on the Case list component. By default, this field is set to the Case \[sn_customerservice_case\] table. Note: Case list component can show the records from any extended table of case or task table. | | Query | Query to filter the case records. The default query shows all cases. Note: If no query is provided, all case records are displayed in the Case list component. For more information, see [Generate an encoded query string through a filter](https://www.servicenow.com/docs/access?context=t_GenEncodQueryStringFilter&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US). | | View | Display style for the cases inside the component, chosen from the predefined views. | | Columns | Display columns from the case or task table. Select Add to add new columns to the case list table. Select (![edit icon]()) to update and select (![Remove icon]()) to remove column from the case list on the column cards. Note: * If both the View and Columns attributes are provided, the fields specified in Columns will be displayed. * If the first column is the reference column, selecting on the case record shows the error in the Case View component. {#component-properties-for-the-case-list__ul_z4c_zmg_ccc} | | Disable column resizing | Option to adjust the column width. By default, column resizing is enabled. | | Records per page | Option to show or hide the number of records that appear by default on the case list. The default value is 20. | | Hide errors | Option to show or hide error messages for the end user on the third-party website. By default, it shows errors. | | Hide when empty | Option to show or hide the component when there are no cases to display. By default, it shows empty list when there are no cases. Note: This property is honored when the component initially loads. If no matching records are found for searches or query filters afterward, an empty state is shown regardless of the attribute's value. | [Table 1. Case list component properties] {#component-properties-for-the-case-list__table_csm_base_entities} **Related tasks** * [Configure the Case list component instance](https://www.servicenow.com/docs/YmSR1fDxMW09qqoMKjH1Gw "Configure the Case list component instance so that your user can embed it on their website to access the list of all cases from their website directly.") * [Embed the Case list component instance on the third-party website](https://www.servicenow.com/docs/FYCE8SZ4QzRznyHfmURWTg "Embed the global code and component code of the Case list component instance that you configured so that you can enable your customers to start using the Case list component instance on your third-party website.") **Related reference** * [Event handler in the Case list component](https://www.servicenow.com/docs/IyAEPT1Z7MHhu7ugU~PjuQ "A component triggers an event when a certain condition is met or on user interaction. The event can be used to execute an action through a code on a third-party webpage.") * [Sample code for the Case list component](https://www.servicenow.com/docs/hG_IAZxsvw08UbKizdPlDg "Sample code is provided to define an action when an event is triggered. Update the sample code for your use case before embedding the component on your webpage.")