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

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Element filters

# Element filters {#ariaid-title1}

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

Element filters enable you to specify or limit the displayed breakdown elements on visualizations.  
An elements filter consists of a conditional filter or related list conditions and the breakdown source that the conditions apply to.  
Tip:  
Use an elements filter with dynamic conditions to create personalized visuals on a widget. For more information, see [Personalized visuals](https://www.servicenow.com/docs/CvO_uJsbdnRF8WdRjjTtNw#personalized-visuals "Configure visuals with dynamic elements to show information that applies only to the person looking at the visual on a dashboard, service portal, or Workspace canvas.").
**Related concepts**   

* [Analytics Hub](https://www.servicenow.com/docs/PygfIDQaoEElV6ECD7oTuA "The Analytics Hub is an exploratory view of indicators, used for more detailed analysis. It lets you see trends, predictions, breakdowns, and associated records for a specific indicator. The Analytics Hub replaces scorecards.")
* [Performance Analytics widgets](https://www.servicenow.com/docs/Da4VULgrw2D2GChwB8IMsg "Widgets enable you to define visualizations for indicator scores. Widgets are shown on dashboards.")  
**Related reference**   

* [Examining indicators with KPI Details](https://www.servicenow.com/docs/DVYJIzggAv0zPfo3DgSSBg "The KPI Details feature enables you to delve into the information behind your key performance indicators. Apply forecasts, trends, targets, and thresholds. Filter by breakdown element or apply time series aggregations.")

## Create an elements filter {#ariaid-title2}

Select the breakdown source and filter conditions to filter breakdown elements from
that breakdown source.

### Before you begin

Role required: pa_data_collector or admin

### Procedure

Navigate to AllPerformance AnalyticsElements Filters and create a new record (see table for field descriptions).  
{#t_CreateElementFilter__table_yvq_m5s_vv__entry__2}

| Field | Description |
|-|-|
| Breakdown source | Select the breakdown source you want to create an element filter for. The element filter is available for any breakdowns based on this breakdown source. |
| Facts table | Read-only. Displays the breakdown source facts table. |
| Filter | CONDITIONS: Specify the filter conditions to limit the available elements. Only elements that meet these conditions are displayed when you apply this element filter. For example, if the breakdown source facts table is User \[sys_user\], you can add a filter condition to include only users in the HR department. This filter condition is \[Department\]\[is\]\[HR\]. For [Personalized visuals](https://www.servicenow.com/docs/CvO_uJsbdnRF8WdRjjTtNw#personalized-visuals "Configure visuals with dynamic elements to show information that applies only to the person looking at the visual on a dashboard, service portal, or Workspace canvas."), the operator in the filter condition must be <kbd class="ph userinput">[is (dynamic)]</kbd>. |
| Filter | RELATED LIST CONDITIONS: Include a relationship with another table in the conditions. For example, you could create an element filter on the Groups breakdown source, which uses the Group \[sys_user_group\] table. If you added a related list condition on Incident \[incident\]-\>Assignment group, you would get only groups that had an incident assigned to them. If this condition included \[\[Created\]\[on\]\[Last 6 Months\]\], you would get groups that were assigned an incident that was created within the last six months. |
| Roles | Select any roles that a user must have to select this element filter on a widget form. A user must have at least one of the specified roles. If no roles are specified, all users who can edit a Performance Analytics widget can add this element filter. |
[Table 1. Element filter fields]

{#t_CreateElementFilter__table_yvq_m5s_vv}

### What to do next

Use an element filter with dynamic conditions to create personalized visuals on a
widget. For more information, see [Personalized visuals](https://www.servicenow.com/docs/CvO_uJsbdnRF8WdRjjTtNw#personalized-visuals "Configure visuals with dynamic elements to show information that applies only to the person looking at the visual on a dashboard, service portal, or Workspace canvas.").

All widget indicators that use this elements filter and all diagnostic results that
mention this elements filter are listed at the bottom of the elements filter
record.

## Element filters in visualizations {#ariaid-title3}

Element filters can be seen in a Platform Analytics data visualization or on KPI Details. In the Core UI, they can be seen in Performance Analytics widgets or the Analytics Hub. Some restrictions apply.  
You can select the element filter in the following ways on different visualizations:

* On the Core UI Analytics Hub: When you select a breakdown, if that breakdown has elements filters, you get a list of them to choose from.
* In a Core UI Performance Analytics widget: When configuring the widget, fill in the Elements filter field in the Element settings tab. Only breakdown, time series, and score widgets support elements filters. For time series and score widgets, an elements filter replaces the first-level breakdown element. For breakdown widgets, an elements filter limits the elements that are shown.
* In a Core UI widget indicator on a time series widget: Select a filter in the Elements filter field in the Element Settings. You must first select a breakdown with element filters on its breakdown source.  
  Note:  
  The names of all elements that get applied are appended to the name or label of the indicator.
* On KPI Details in Platform Analytics: When you select a breakdown in the Filters pane, if that breakdown has elements filters, you get a list of them to choose from under Refine by.
* In a Platform Analytics data visualization: While configuring the data visualization, select an indicator data source, a breakdown, and the \[is (dynamic)\] operator. Any elements filters for that breakdown are then available in the Element field. Only automated indicators with the Count, Minimize, or Maximize aggregate are supported.
{#element-filters-visualizations__ul_yjt_n1b_wtb}

In all of these cases, you can select an elements filter only if you first select a breakdown with at least one elements filter on its breakdown source. You may also need a certain role to select an elements filter, depending on the
configuration of that filter.

Besides specifying an elements filter on a visualization, you can specify a Default element filter on a breakdown record. That elements filter is selected automatically for that breakdown in any visualization.
Users that view the breakdown on the Analytics Hub or on KPI Details can change or clear the selected elements filter.  
Note:  
It is not possible to change elements filters that are used to personalize visuals when simply viewing the visual on a dashboard or workspace. Only a user with the rights to edit the underlying widget or data visualization can change the elements filter. For more information, see [Personalized visuals](https://www.servicenow.com/docs/CvO_uJsbdnRF8WdRjjTtNw#personalized-visuals "Configure visuals with dynamic elements to show information that applies only to the person looking at the visual on a dashboard, service portal, or Workspace canvas.").

*[\>]: and then