Hide or show categories in the Data List widget

task australia Updated Sep 10, 2026 1 min read create-cond-script-datalist-widget.md

Create a condition script to hide or show a category 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

Role required: sp_admin

Procedure

Navigate to All > System Extensions Points > Scripted Extensions Points.
On the Extension Points page, in the API Name column search field, enter *datalist.
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.
On the DatalistCategoryConditionScript page, in the Related links, select Create implementation.

In the Script field, paste the following CSS code:

Shell

showCategory: function(category_id, params) { 
      /*       if(category_id=="cases_category"){           return true;       }       */       return true;     }

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" } Text `</td></tr></tbody></table>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.`

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

Text

</td></tr></tbody></table>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**.

104 lines · 2.8 KB Wrap lines

---
title: Hide or show categories in the Data List widget
description: Create a condition script to hide or show a category in the Portal Data List widget.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/create-cond-script-datalist-widget.html
release: australia
product: Customer Self-service and Omnichannel Engagement
classification: customer-self-service-and-omnichannel-engagement
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Portal Data List widget, Set up Configurable Portal widgets, Set up self-service, Configure, Customer Service Management]
---

# Hide or show categories in the Data List widget

Create a condition script to hide or show a category 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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/activate-config-portal-widget.md)

Role required: sp\_admin

## Procedure

1.  Navigate to **All** &gt; **System Extensions Points** &gt; **Scripted Extensions Points**.

2.  On the Extension Points page, in the **API Name column** search field, enter `*datalist`.

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:

    ```
    showCategory: function(category_id, params) { 
    
          /* 
          if(category_id=="cases_category"){ 
              return true; 
          } 
          */ 
          return true; 
        }
    ```

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

Parameters

</th><th>

Description

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

category\_id

</td><td>

Portal Data List category id.

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

params

</td><td>

JSON containing url\_params and related\_table. For example,```

{
  "url_params": {
    "table": "customer_contact",
    "sys_id": "60beb5e7d7600200e5982cf65e6103ad",
    "view": "sp"
  },
  "related_table": "sn_customerservice_case"
}

```

</td></tr></tbody>
</table>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**.