Custom interactive filters
As an administrator, you can create scripted interactive filter widgets to provide advanced filtering options on dashboard reports.
With a custom interactive filter, you can control aspects of the filter interface and filtering logic. Create filters that fit your specific needs. Custom interactive filters include filters that perform multiple, common filtering operations with a single click.
Custom filters are scripted System UI Widgets that use the DashboardMessageHandler JavaScript class to define and publish report filters.
Role required: hp_publisher_admin and report_admin. The hp_publisher_admin role exists only for managing interactive filters in Core UI. By default, it contains the role analytics_filter_admin for managing Core UI filters that are migrated to Platform Analytics experience. It isn't possible to create Core UI interactive filters in net new instances from Yokohama forward.
Note: The exposed API for custom interactive filters is limited and does not provide parity with standard interactive filters. Before implementing any custom interactive filters, review the Custom interactive filter limitations.
Access control lists on the Table API may restrict the records shown when a dashboard is filtered. To alleviate this problem, add users or roles to the Table API access control list. For more information, see Access control list rules.
The code that publishes the filter must call the SNC.canvas.interactiveFilters.setDefaultValue() method and it must call the dashboardMessageHandler.publishFilter() method to publish the filter.
Define the appearance of the widget, such as available buttons, using Jelly.
You can add multiple custom interactive filters to the same dashboard. The filters must have unique IDs in the filter object and unique IDs for the DashboardMessageHandler.
- Custom interactive filter examples
As an administrator, you can create custom interactive filter widgets to provide advanced filtering options on dashboards. - Use the Debug filter
The debug interactive filter helps you create custom filters. This filter displays a JSON array representation of all active filters on a dashboard. - Custom interactive filter limitations
Custom interactive filters are a fallback for use when standard interactive filters do not provide certain functionality. - DashboardMessageHandler
Provides methods to define custom filtering logic for interactive filters. - Dynamic JavaScript filters
Create dynamic conditions in JavaScript that you can configure as part of a report visualization's criteria instead of specified values.
Parent Topic:Interactive Filters
--- title: Custom interactive filters description: As an administrator, you can create scripted interactive filter widgets to provide advanced filtering options on dashboard reports. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/now-intelligence/core-ui-interactive-filters/c\_CustomPublishers.html release: australia product: Core UI Interactive Filters classification: core-ui-interactive-filters topic_type: concept last_updated: "2026-09-10" reading_time_minutes: 2 breadcrumb: [Interactive Filters, Reporting, dashboards, and Performance Analytics in the Core UI, Platform Analytics] --- # Custom interactive filters As an administrator, you can create scripted interactive filter widgets to provide advanced filtering options on dashboard reports. With a custom interactive filter, you can control aspects of the filter interface and filtering logic. Create filters that fit your specific needs. Custom interactive filters include filters that perform multiple, common filtering operations with a single click. Custom filters are scripted **System UI** **Widgets** that use the DashboardMessageHandler JavaScript class to define and publish report filters. Role required: hp\_publisher\_admin and report\_admin. The hp\_publisher\_admin role exists only for managing interactive filters in Core UI. By default, it contains the role analytics\_filter\_admin for managing Core UI filters that are migrated to Platform Analytics experience. It isn't possible to create Core UI interactive filters in net new instances from Yokohama forward. **Note:** The exposed API for custom interactive filters is limited and does not provide parity with standard interactive filters. Before implementing any custom interactive filters, review the [Custom interactive filter limitations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/custom-if-limitations.md). Access control lists on the Table API may restrict the records shown when a dashboard is filtered. To alleviate this problem, add users or roles to the Table API access control list. For more information, see [Access control list rules](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/access-control-rules.md). The code that publishes the filter must call the SNC.canvas.interactiveFilters.setDefaultValue\(\) method and it must call the dashboardMessageHandler.publishFilter\(\) method to publish the filter. Define the appearance of the widget, such as available buttons, using Jelly. You can add multiple custom interactive filters to the same dashboard. The filters must have unique IDs in the filter object and unique IDs for the [DashboardMessageHandler](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/c_DashboardMessageHandler.md). - **[Custom interactive filter examples](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/r_CustomPublisherExample.md)** As an administrator, you can create custom interactive filter widgets to provide advanced filtering options on dashboards. - **[Use the Debug filter](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/c_DebugPublisher.md)** The debug interactive filter helps you create custom filters. This filter displays a JSON array representation of all active filters on a dashboard. - **[Custom interactive filter limitations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/custom-if-limitations.md)** Custom interactive filters are a fallback for use when standard interactive filters do not provide certain functionality. - **[DashboardMessageHandler](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/c_DashboardMessageHandler.md)** Provides methods to define custom filtering logic for interactive filters. - **[Dynamic JavaScript filters](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/dynamic-js-filters.md)** Create dynamic conditions in JavaScript that you can configure as part of a report visualization's criteria instead of specified values. **Parent Topic:**[Interactive Filters](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/core-ui-interactive-filters/c_HomepagePublishers.md)
| title | Custom interactive filters |
| description | As an administrator, you can create scripted interactive filter widgets to provide advanced filtering options on dashboard reports. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/now-intelligence/core-ui-interactive-filters/c\_CustomPublishers.html |
| release | australia |
| product | Core UI Interactive Filters |
| classification | core-ui-interactive-filters |
| topic_type | concept |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | Interactive FiltersReportingdashboardsand Performance Analytics in the Core UIPlatform Analytics |