filters Properties

The filters key defines all global filters included in the dashboard. It contains a separate node, with configurable properties, for each global filter. Global filters apply to all layouts, but you can specify whether each widget applies the global filters.

Property NameDescription
labelField label displayed in the global filter
fieldsAPI name of the field by which to filter the records; a global filter can’t be based on multiple fields
operatorFilter operator; supported operators are in (equals), not in (doesn’t equal), and matches (contains)
lockedPrevents dashboard viewers from being able to change the global filter and for an incoming filter passed from a linked dashboard to overwrite the global filter
datasetContains the name field, which specifies the API name of the dataset that contains the filter field.
valueArray of field values used to filter the records

Example dataset:

To view an example of the filters key configured with the properties in the table, see filters JSON. Each hash contains the configured properties for a single filter.