---
sourceDocument: Australia Platform Analytics
sourceDocumentLink: https://www.servicenow.com/docs/r/now-intelligence

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Domain filters

# Create a domain filter {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read  
Create a domain filter so that you can filter data visualizations on domains in a
domain-separated instance. Domain filters enable the user to see data associated with one or
more domains.

## Before you begin

Domain filters are available on instances with domain separation enabled. Domain filters are not automatically enabled by default. To enable them, install these two plug-ins:

* com.glide.domain.msp_extensions.installer
* com.snc.pa.domain_support

{#create-domain-filter__ul_prl_l2w_1wb}For more information, see [Domain separation for
service providers](https://www.servicenow.com/docs/access?context=domain-sep-landing-page&version=australia&pubname=australia-platform-security&ft:locale=en-US). Domain filters are a different component than the Filter component.

Role required: ui_builder_admin or admin.

## About this task

Domain filters support both the instance's list of domains and Performance Analytics
domain configurations. Filters based on the domain list provide different results
than filters based on domain configurations. For more information, see [Differences between domain list and domain configuration filters](https://www.servicenow.com/docs/gj8rTyknMR6phBAvODGUHQ#platform-domain-list-vs-pa-domain-config-filters "Domain filters based on Performance Analytics domain configurations behave differently than domain filters based on the list of platform domains.").

The filter applies to all elements on the same dashboard or the same dashboard tab, depending on filter placement. Filters on dashboard tabs have higher priority than top-level filters.

## Procedure

1. Open AllPlatform AnalyticsLibraryDashboards.
2. Locate the dashboard in the dashboard library and open it for editing, as described in [Edit Platform Analytics dashboards](https://www.servicenow.com/docs/xcdJKUGCj6FylAmpDMYZzA "You can edit dashboard and dashboard tab information in the inline editor. If the dashboard has been shared, any changes you make are applied globally.").  
   Note:  
   These instructions are for using the inline dashboard editor. If you're editing a technical dashboard in the UI Builder, see the [Component reference](https://developer.servicenow.com/dev.do#!/reference/next-experience/xanadu/shared-components/sn-pa-domain-filter/overview) on the Developer Site.
3. Create or open the dashboard that you want to add a domain filter to.  
   For more information, see [Edit Platform Analytics dashboards](https://www.servicenow.com/docs/xcdJKUGCj6FylAmpDMYZzA "You can edit dashboard and dashboard tab information in the inline editor. If the dashboard has been shared, any changes you make are applied globally.").
4. Select Edit.
5. From the Add new element menu, select Domain filter.  
   The domain filter is added to the dashboard layout in the first available space. This location may be below existing dashboard elements.
6. Select the domain filter's three-dot menu and choose Configure.  

   <br />

7. In the Filter label field, type a meaningful name for the filter.  
   This name is the name that the user sees.
8. To determine what data to display in your filter, configure the domain display and whether to include domain data.
   1. Select the Domain display.  
      You can filter on either a Performance Analytics domain configuration or a standard domain list.  

      {#create-domain-filter__table_tnq_4dr_5qb__entry__2}

      | Options | Description |
      |-|-|
      | Use the Performance Analytics domain configuration | Enables users to filter results based on a domain configuration. To learn more about domain configurations, see [Grouping domains in Performance Analytics domain configurations](https://www.servicenow.com/docs/Y6reWfYX4MLtQLBVNi0qOw "Instead of configuring Performance Analytics for the domains of a specific user, create a reusable domain configuration. Select domains that are visible to a group of users, or filter domains directly. Domain configurations let you define hierarchical relationships and aggregate scores across multiple domains."). |
      | Use the standard domain list | Enables users to filter results based on the list of domains. The list shows only active domains. Aggregations aren't included. |
      [ ]

      {#create-domain-filter__table_tnq_4dr_5qb}

      For a more detailed description of how these properties affect the results of the filter, see [Differences between domain list and domain configuration filters](https://www.servicenow.com/docs/gj8rTyknMR6phBAvODGUHQ#platform-domain-list-vs-pa-domain-config-filters "Domain filters based on Performance Analytics domain configurations behave differently than domain filters based on the list of platform domains.").
   2. Choose whether to Include global domain data.  
      When selected, the filter includes values from records in the global domain. The global domain usually contains only configuration records.
   {#create-domain-filter__substeps_whh_ycr_5qb}
9. Select Save.
{#create-domain-filter__steps_kvs_3hf_qvb}
**Related concepts**   

* [URL filter parameters for dashboard filters](https://www.servicenow.com/docs/HCc1BJ_clejO~uWxlGC1YA "URL filter parameters enable users to encode filter selections directly in dashboard URLs, allowing bookmarkable, shareable dashboard states with automatically apply filters. The URL parameter is called unifiedFiltersParam and is appended as a path segment after the dashboard sys_id.")  
**Related tasks**   

* [Create or add a filter on an inline dashboard](https://www.servicenow.com/docs/EgipF0if1yb5FCroSh3bHw "Create a filter or select one from the filter library. When creating a filter, name it, and choose whether to create a single select, multiple select, date, or true/false filter.")
* [Create a filter in the Filter Designer](https://www.servicenow.com/docs/H1MeS2i6mEkpi6rSEuMV5A "Create a Platform Analytics filter in the Filter Designer and add it to the library for reuse.")
* [Create a filter group](https://www.servicenow.com/docs/a8OIBtumq_cK5aRp44aA8A "Create a set of filters that you can apply simultaneously. When you have multiple filters, applying them all together can be faster than applying them separately.")
* [Create a filter on a technical dashboard in UI Builder](https://www.servicenow.com/docs/BRYIfAUABP~sViA_N_lmsQ "To filter data visualizations and simple lists in a technical dashboard, add a filter component in UI Builder and configure event handlers.")
* [Make a data visualization act as a filter](https://www.servicenow.com/docs/m~lEmLrvp7AhYVI4cZdsSA "You can set a data visualization to act as a filter on a dashboard that contains it. Only table or indicator data can be so filtered.")
* [Configure a Single/Multiple select or cascading filter](https://www.servicenow.com/docs/RLvttlx0xmUgN51EJkD4hg "Let users filter a dashboard tab on one or more values from a set of choices, such as incident priority. You can have a single or multiple select filter follow another filter in a cascade.")
* [Configure a True/False filter](https://www.servicenow.com/docs/OoOsSrfFZMiXR2pZhr1BUQ "Let users filter on true/false fields and breakdown elements. For example, you can enable users to choose only the incidents where the Active field is set to true.")
* [Configure a Date filter in the inline editor](https://www.servicenow.com/docs/ZB4Qad9YdPHV5uIA0kAjgQ "Let users select predefined periods or specify custom start and end dates for the data on a dashboard tab.")
* [Edit a Platform Analytics filter on a dashboard](https://www.servicenow.com/docs/wB2BfRc4lryVoLnurXIDbQ "When you highlight a filter on a dashboard that you have put into edit mode, you have several editing options depending on whether the filter is local to the dashboard or saved in the library.")  
**Related reference**   

* [Platform Analytics filter tables](https://www.servicenow.com/docs/XYjXgV8G~j0HQItGRtBOLQ "The following tables relate to Platform Analytics filters and can be accessed through scripts.")

## Differences between domain list and domain configuration filters {#ariaid-title2}

Domain filters based on Performance Analytics domain configurations
behave differently than domain filters based on the list of platform domains.

### Overview of differences {#platform-domain-list-vs-pa-domain-config-filters__section_zzc_vpm_fpb}

The results of domain filtering differ based on the presence of child domains and the
inclusion of the global domain. If you use domain configurations, results also
depend on aggregation.

### Platform domain list {#platform-domain-list-vs-pa-domain-config-filters__section_qdc_5pm_fpb}

Global domain included
:

    Visualizations based on indicator data
    :   Show only the scores for the selected domain. Child domain and global domain scores are not included. The values can come from both [data collection jobs](https://www.servicenow.com/docs/0BmHD84G7z5nj9ylwlJX_g#gloss-data-collector "A scheduled job that collects data from one or more indicator sources to produce indicator scores.") and manual input.

    Visualizations based on table data or [database views](https://www.servicenow.com/docs/0BmHD84G7z5nj9ylwlJX_g#gloss-database-view "A database view defines table joins for reporting purposes. For example, a database view can join the Incident table to the Metric Definition table. This view can be used for an indicator source.")
    :   Combine the values of the global and selected domains, and
        any child or parent domains.

Global domain not included
:

    Visualizations based on indicator data
    :   Show only the score for the selected domain. Child domain
        and global domain scores are not included.

    Visualizations based on table data or database views
    :   Combine the values of the selected domain and the values of
        the child domains.

### Performance Analytics domain configurations {#platform-domain-list-vs-pa-domain-config-filters__section_y2t_5pm_fpb}

See [Grouping domains in Performance Analytics domain configurations](https://www.servicenow.com/docs/Y6reWfYX4MLtQLBVNi0qOw "Instead of configuring Performance Analytics for the domains of a specific user, create a reusable domain configuration. Select domains that are visible to a group of users, or filter domains directly. Domain configurations let you define hierarchical relationships and aggregate scores across multiple domains.")
for a detailed discussion of domain configurations.  
Once you group domains in a Performance Analytics domain configuration, there are two considerations when you filter on a domain in that configuration:

* Does the domain have children or is it a standalone domain?
* Is the data aggregated?
{#platform-domain-list-vs-pa-domain-config-filters__ul_qg5_lzw_gpb}  

Global domain included
:

    Visualizations based on indicator data

    :   Show only the scores for the selected domain, and only if a data collection job collected indicator scores for that domain.Aggregated scores come from all domains in the
        domain configuration, but exclude child domains. The
        global domain is also excluded.

    Visualizations based on table data or database views

    :   Include values from the selected domain, any child domains of that domain, and the global domain.Aggregated results
        come from all domains in the configuration, including
        their child domains, plus the global domain.

Global domain not included
:

    Visualizations based on indicator data

    :   Show only the scores for the selected domain. Child domains and the global domain are excluded.Aggregated scores come
        from all domains in the domain configuration, but
        exclude child domains. The global domain is also
        excluded.

    Visualizations based on table data or database views

    :   Include the values of the selected domain and children of the selected domain, if present. Global domain values are not included.Aggregated results come from all domains in
        the domain configuration plus any children of domains in
        that configuration. Global domain values are not
        included.

**Related concepts**   

* [Approaches to Performance Analytics with domain separation](https://www.servicenow.com/docs/6hRszlf7z8VVs_U5CQ~BWw "When using Performance Analytics with domain separation, you can collect domain-specific scores. You can use global or domain-specific Performance Analytics table records or even a combination of both.")

*[\>]: and then