custom filter in the new Platform Analytics dashboard

Hirokazu Dekiok · ‎10-04-2024

In the old Performance Analytics dashboard, I used a custom filter like the one in the following URL:

https://docs.servicenow.com/bundle/xanadu-now-intelligence/page/use/dashboards/reference/r_CustomPub...

Is there a way to create a similar custom filter in the new Platform Analytics dashboard?

I have looked into "https://docs.servicenow.com/" and other sites, but have not been able to find a working solution, so I would appreciate your help.

jeffrubinoff · ‎07-23-2025

I don't think there is a general case, but here is an example from Knowledge 2025 of creating a custom filter: https://servicenow-events-or-lab-guidebo.gitbook.io/knowledge-2025/ccl1260-k25/exercise-5-show-only-...

View solution in original post

Hirokazu Dekiok · ‎07-23-2025

✅ How to Implement a Custom Filter in ServiceNow UI Builder

I figured this out on my own, so I'm sharing the solution here in case it helps others.
This implementation allows you to apply filters based on the value selected in a dropdown.
Please note that the dropdown options need to be manually configured as desired.

🛠️ Implementation Steps

1. Place a custom filter component

In this case, I used a Dropdown component.

2. Create the following client state parameters

parFilters (JSON)
encodedQueries (JSON)
textFilterPresence (String)
shortDescription (String)

3. Create a client script

Script name: filter with encoded query

Use the following code:

/**
* @param {params} params
* @param {api} params.api
* @param {any} params.event
* @param {any} params.imports
* @param {ApiHelpers} params.helpers
*/
function handler({api, event, helpers, imports}) {
    // Set icon based on text filter presence
    api.setState("textFilterPresence", api.state.shortDescription ? 'presence-available-outline' : null);

    const mergePARFiltersV2 = imports"global.mergePARFilters".v2;

    const appliedFilters = [{
        order: 0,
        filterId: "",
        type: "query",
        label: "Short Description",
        apply_to: ["[YOUR_TABLE_NAME]"], // Replace with the table(s) you want to filter
        encoded_query: api.state.shortDescription ? `${api.state.shortDescription}` : null,
        extraValues: {},
        include_unmatched_or_empty: false
    }];

    api.setState("parFilters", ({ currentValue, api }) => {
        const { parFilters, encodedQueries } = mergePARFiltersV2(currentValue, appliedFilters);
        api.setState("encodedQueries", encodedQueries);
        return parFilters;
    });
}

4. Configure events on the dropdown component

On “Selected item changed”: store the value into shortDescription
Also trigger the filter with encoded query script

If any part of this explanation is unclear or if you need help adapting it to your specific use case, please feel free to ask!

View solution in original post

DanielB54292415 · ‎01-16-2025

Yes! Id like to bump this question as there is a lack of information on this. While there are some other articles regarding UI builder and adding encoded queries using parFilter events, there is nothing that shows us how to create a new filter for the platform analytics dashboard, I expect it to need the CLI, but again no information on how to even start creating anything like this...

Duane van Gesse · ‎01-16-2025

Still no answer??? Lack of Custom Intractive Filters within Platform Analytics is a major issue.

Richard Mansfie · ‎04-03-2025

Also needing a customer filter option or at the bare minimum a free text box to search a string field.

NITINRAVLANI · ‎04-05-2025

The Answer is to create a Technical Dashboard where you can use ui builder to achieve this.

https://www.servicenow.com/docs/bundle/yokohama-now-intelligence/page/use/dashboards/task/create-tec...

Use components to create a custom filter and then configure an event to filter data.

Please see steps in provided links.