How to

Dashboard Filters

Use dashboard filters to narrow charts and KPIs by date, date range, and other variable values without editing the dashboard itself.

Updated July 11, 2026

Dashboard filters let you change the values sent to dashboard widgets before the dashboard runs its queries. They are useful when you want to inspect a different time period, focus on one segment, or compare a new slice of data without rebuilding the dashboard.

Open and update a filter

  1. Open the dashboard you want to explore.
  2. Click a filter chip near the top of the dashboard.
  3. Change the value, then click Apply to refresh the dashboard with that filter.

If you want to discard your draft changes, click Reset to return the filter to its default value.

Custom query filters

Custom query filters load their options from a SQL query defined on the widget. When configuring the filter in widget edit, you can choose Multi-select (default) or Single select under Selection mode.

  • Multi-select lets you pick multiple values and includes Select All / Apply controls on the dashboard.
  • Single select lets you pick one value at a time; the choice applies immediately when you select it.

The selection mode is set in widget edit and cannot be changed from the dashboard filter bar.

Use date range presets

For date range filters, you can choose a preset such as Week Range, Month Range, or Year Range before picking dates from the calendar.

  • In Custom Date Range, select a start date and end date directly.
  • In preset modes, click a day in the calendar and FireAI expands it to the full week, month, or year for that selection.
  • The calendar popup also includes Compare Previous Period, Reset, and Apply, so you can finish the date-range change without leaving the calendar.

Compare the previous period

Some dashboard date range filters include a Compare Previous Period toggle. Turn it on before applying the filter when you want the dashboard to compare the selected range against the immediately preceding one.