---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Pass global filters to the dashboard page template

# Pass global filters to the dashboard page template {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Global filters are sent to the dashboard serve as filters for the visualizations within the dashboard. These filters are merged with existing filters in the dashboard.

## About this task

Global filters are filters that apply to visualizations on the target dashboard. These filters apply to all relevant data visualizations. The format of the value passed to globalFilter is the stringified form of {encodedQueries: 'encoded-queries-string', filters: 'PAR-Filter'}. Both encodedQueries and filters are transformed into Platform Analytics filters internally and merged with the existing filters on the dashboard.  
Either `encodedQueries`, `filters`, or both can be specified. In the following example, equivalent `encodedQueries` and `filters` values both filter visualizations that show records from the Incident \[incident\] table based on a State field value of 1 or 2:

    JSON.stringify({
        encodedQueries: {incident: 'stateIN1,2'},
        parFilters: [{ order: 0, apply_to: ['incident.state'], values: ['1', '2'] }]
    })

Configure links to dashboards on UI Builder pages to open dashboards that are already filtered.

## Before you begin

Role required: admin

## Procedure

1. Navigate to the UI Builder you want to add a global filter to.
2. Configure the behavior of the hyperlink or button (or something else) on the page to point to the dashboard with the specified sys_ID.  
   In this example, the sys_ID is 1238.

   The showInfoMessage parameter, if true, shows the configured infoMessage on the linked dashboard when filters are passed.

       api.emit('NAV_ITEM_SELECTED', {
               route: 'dashboards',
               params: {
                   sysId: '1238',
                   unifiedFilters: JSON.stringify({
                       showInfoMessage: true, // default false
                       infoMessage: 'custom info message', // if not passed and if showInfoMessage is true then the default message is displayed
                       encodedQueries: {
                           incident: 'priority=1'
                       },
                   })
               }
           });