--- sourceDocument: Brazil Customer Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/customer-service-management Release : - brazil ft:locale : - en-US ft:publication_title : - Brazil 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: Brazil Updated September 10, 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 allows you to display and configure case records on a third-party website. By adjusting its properties, you can control the visibility, filtering, display, and interaction options to tailor the case list to your specific needs. Show full answer Show less ## Key Features * **Header Controls:** Options to hide or show the header, record count, search button, filter button, refresh button, and last refreshed text, enabling you to customize the user interface based on your requirements. * **Data Source Configuration:** Specify the source table for cases or tasks, defaulting to the Case \[sncustomerservicecase\] table. You can also provide a query to filter displayed records or show all cases if no query is applied. * **Display Customization:** Choose display styles through predefined views or specify columns to show. If both are set, column selections take precedence. You can also enable or disable column resizing for better control over the layout. * **Pagination and Error Handling:** Set the number of records displayed per page (default is 20) and decide whether to show error messages to end users on the website. * **Empty State Behavior:** Configure whether the component should be visible when there are no cases to display. Note that this applies only on initial load; subsequent empty results from searches or filters show an empty state regardless. ## Practical Application ServiceNow customers can use these properties to embed a case list onto external websites with a customized appearance and behavior. This flexibility helps improve user experience by allowing precise control over what information is shown and how users interact with case data externally. Proper configuration ensures relevant cases are displayed, users can search and filter efficiently, and the component integrates seamlessly within the third-party environment. 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=brazil&pubname=brazil-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/8NQqKOv_7vqxmahfEw9wPA "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/g5RQpaOHa53R2TE38oO3Ww "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/5UuZs2oMbTQKEq3ATtokJw "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/~tcSAf4X0XDyaMtIJBrjFQ "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.")