Create a filter in the Filter Designer

task brazil Updated Oct 29, 2026 2 min read add-filter-library.md
Raw file servicenow.com

Create a Platform Analytics filter in the Filter Designer and add it to the library for reuse.

Before you begin

Note: Filters that are saved to the filter library aren't accessible in the technical editor or other UI Builder pages.

Role required: analytics_filter_admin, admin

Procedure

  1. To add a filter to the filter library, navigate to Platform Analytics > Library > Filters and select New.

    You can also navigate to this library from other Platform Analytics library pages.

    The Filter Designer opens.

  2. Select the type of data to filter.

    Other configuration options vary depending on the data type you select.

    • Single select: A single value from a set of choices. Single select is the default filter type.
    • Multiple select: More than one value from a set of choices, such as both High and Critical Priority
    • Date: A calendar date. You can also set a time. Automatically applies to all indicator data on page or tab.
    • True/False: Whether a field value is true or false. Can also be used with indicator breakdowns that are based on a bucket group with only two values.
  3. Choose the Filter Element.

    Element options depend on the filter type, but include Pill, Checkboxes, and Typeahead.

  4. In the Filter label field, type a meaningful name for the filter.

    This name is the name that the user sees.

  5. Choose the filter source.

    Options include:

    • Tables

      Select the table to filter.

    • Indicators

      Select the breakdown to use as the filter.

    • Usage Insights

      Select the Usage Insights property to filter on. For more information, see Filter data in Usage Insights.

  6. Choose one or more Default values.

    Single select and True/False filters support one default value. Multiple select filters support multiple default values.

  7. For multiple select filters, select Allow reset to default.

Result

On saving, the filter is saved to the library, where any user can add it to their dashboards.

What to do next

See these topics for further configuration options:

Search documentation
Search document titles and file paths on the brazil branch