Filters and date ranges
An Intelligence widget's number is shaped by three controls, layered in a fixed order: the board's period picker, the widget's own config, and which sources this board has connected. Here's how each one changes what gets counted.
The board period picker — visible only when a widget on this view actually uses it.
The board period picker
Above the grid you'll see 7d / 14d / 30d / 90d presets plus Custom (two date inputs). It only appears when at least one widget on the current view is time-aware — a static widget like Status Distribution doesn't need it, so it doesn't clutter the view. The choice is written into the URL (?period=30d, or ?from=…&to=…), so a filtered view is a link you can share or bookmark, and it survives a page refresh.
Clearing the picker (the × next to an active selection) removes the override entirely — every time-aware widget falls back to its own default range.
How it combines with a widget's own range
Every widget also has its own default range, set with the gear icon on its header (Configure Widget) — typically a Range field of 4, 8, or 12 weeks depending on the widget. When the board period picker is on, it overrides that per-widget default for every time-aware widget on the view; when it's cleared, each widget's own saved config applies again. A widget with no configurable options shows "This widget has no configurable options" in that dialog instead of empty fields.
Server-side, an explicit from/to pair always wins over a day count, and a widget with neither falls back to its own documented default (commonly the last 30 days).
Which sources a widget needs
Opening + Add Widget groups the catalog by what it reads — Pull Requests, Issues, Commits, Board State. A widget that needs a source this board hasn't connected is shown greyed out with a reason, e.g. "Needs GitHub." — you can still see it, but adding it is disabled until the source is attached. A widget you already added, whose required source was later removed, renders the empty-state card described in How a widget gets its number rather than a blank tile.
Filtering into a single value
Some widgets (developer tables, PR scatter plots) let you click a row or point to narrow the same query to that single value — see Drilling into a person or a ticket for exactly where that click takes you.
If it looks wrong
| Symptom | Cause | Fix |
|---|---|---|
| Period picker is missing entirely | No widget on this view is time-aware | Expected — add a trend/time-based widget to see it |
| Changing the period picker doesn't change a specific widget | That widget isn't time-aware, or its own config already sets an explicit from/to | Check the widget's own Configure dialog |
| A widget I want to add is greyed out | Its required source isn't connected to this board | Connect the source named in the reason text, on the Sources tab |
Related
- How a widget gets its number — why a widget reads zero even inside the right window.
- Drilling into a person or a ticket — where a filtered click takes you.
- Comparing boards side by side — the same period picker, applied across boards.
Last updated