Dashboards

Dashboards

A dashboard is a named canvas that groups one or more widgets into a page. Dashboards live in collections and can be locked into published blueprints.

Creating a dashboard

1. Open Dashboards in the left sidebar.
2. Click the + next to a collection, or use the New Dashboard button in an empty collection.
3. Enter a name. The dashboard opens immediately.

Adding widgets

Click Add Widget in the toolbar. The Widget Builder opens with three authoring tabs:

Tab	When to use
Query Builder	Structured chip-based authoring — pick a source, metric, dimension, filters. The SQL compiles automatically.
Raw SQL	Direct SQL entry for complex queries the chips can’t express — window functions, percentiles, recursive CTEs.
AI Suggest	Describe what you want; Sidekick generates the widget.

All three tabs produce byte-identical widget configs when given the same intent. A widget built via chips is fully editable in the Raw SQL tab and vice versa.

Filters

Global dashboard filters narrow every widget on the page simultaneously. Add a filter from the toolbar:

• Date range — applies a WHERE ts BETWEEN :start AND :end clause to every time-aware widget.
• Dimension filter — adds a WHERE column = :value (or IN, LIKE, etc.) clause.
• Cross-filter — clicking a bar/point/slice in one widget filters all other widgets by the selected value. Enable per-widget in widget settings.

Collections and groups

Dashboards are organized into collections (top-level folders). Within a collection, dashboards can be arranged into groups (sub-folders visible in the sidebar).

Drag and drop dashboards and groups to reorder them.

Blueprints

A blueprint is a locked, shareable template of a dashboard. Publish a dashboard to a blueprint to:

• Share it across environments (copy to another namespace)
• Lock the layout so casual users can’t accidentally break it
• Version-stamp a known-good configuration

Publish via the Publish to Blueprint action in the dashboard toolbar.

Version History

Every save creates a revision. Access Version History from the left sidebar to compare or restore any previous state.

Keyboard shortcuts

Shortcut	Action
Ctrl+Z / Cmd+Z	Undo last widget change
Ctrl+S / Cmd+S	Save dashboard
Space + drag	Pan the canvas
Ctrl+Scroll	Zoom canvas