---
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


---

# Modify view in the Data List widget

# Modify view in the Data List widget {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Create a condition script to modify views in the Portal Data List widget.

## Before you begin

The UI Components for Customer Portals plugin must have been activated. For more information, see [Activate the UI Components for Customer Portals plugin](https://www.servicenow.com/docs/08umwBf4NNZ1Zkike~EuXg "You can activate the UI Components for Customer Portals plugin (sn_ciwf_ui_cmpnt) to enable Configurable Portal widgets. The application installs related plugins if they aren’t already installed.")

Role required: sp_admin

## About this task

{#update-view-in-datalist-widget__table_k4r_1s5_c3c__entry__3}

| Priority | Source | Description |
|-|-|-|
| 1 (Highest) | Script | If a Views Condition Script is configured and returns a view name, that view is used. Scripts have the most flexibility since they can apply custom logic using the parameters - `categoryId`, `params`. |
| 2 | role_based_views / guest_view | If no script is configured or the script doesn't return a view, the system checks the JSON instance options. * For logged-in users, it checks `role_based_views` to find a view matching the user's roles. * For non-logged-in users, it uses `guest_view` {#update-view-in-datalist-widget__ul_lnt_h55_c3c}. |
| 3 | view | The widget uses the view JSON instance option if the script or role based view/guest view mappings doesn't apply. |
| 4 (Lowest) | Default View on Platform | If no other configuration applies, the widget uses the platform's default view for the table. |
[Table 1. Priority order for how the Data List widget determines the view]

{#update-view-in-datalist-widget__table_k4r_1s5_c3c}

## Procedure

1. Navigate to AllSystem Extensions PointsScripted Extensions Points.
2. On the Extension Points page, in the API Name column search field, enter <kbd class="ph userinput">*datalist</kbd>.
3. Select the sn_ciwf_ui_cmpnt.DatalistCategoryConditionScript in the API Name column.  
   If a message appears about the application scope, select here to be able to edit the record.
4. On the DatalistCategoryConditionScript page, in the Related links, select Create implementation.
5. In the Script field, paste the following CSS code:  


       getView: function(category_id, params) {
           return "case"; // view
       }

   {#update-view-in-datalist-widget__table_r5r_kyx_13c__entry__2}

   | Parameters | Description |
   |-|-|
   | category_id | Portal Data list category id. |
   | params | JSON containing url_params and related_table. For example, { "url_params": { "table": "customer_contact", "sys_id": "60beb5e7d7600200e5982cf65e6103ad", "view": "sp" }, "related_table": "sn_customerservice_case" } |
   [Table 2. Function parameters]

   {#update-view-in-datalist-widget__table_r5r_kyx_13c}
6. Copy the name of a condition script from the Name field.
7. Select Update.
8. Navigate to your portal home page.
9. On the Data List widget, press Control+right-click.
10. Select Instance Options.
11. In the Behavior section, paste the name that you copied into the Data List condition script field.
12. Select the condition script from the list.
13. Select Save.
{#update-view-in-datalist-widget__steps_vdd_qkx_d3c}

*[\>]: and then