Revenue by week
Chart block
Query-to-chart analytics
Dashboards connects visual query building, editable SQL, configurable charts, variables, refresh controls, and resizable layouts in one workspace.
The interface preview uses illustrative data and disabled controls. Available charts, query results, refresh behavior, and collaboration options depend on configured connections, permissions, and deployment.
Dashboard chart
Sample configuration - no live data connection or query execution
Selection
Generated SQL
SELECT
date_trunc('month', orders.created_at) AS month,
SUM(orders.total_amount) AS revenue
FROM public.orders
WHERE orders.status = 'completed'
GROUP BY 1
ORDER BY 1 ASC
LIMIT 12;Chart preview
Chart preview
Dashboards keeps the path from question to chart visible. Start with the visual builder or write SQL directly, configure the chart, then arrange the resulting blocks in a dashboard without separating the query from its presentation.
The visual builder lets you choose a source and table, select columns, add filters and joins, set sorting, and apply a row limit. Its state can generate SQL for inspection and editing. Use that path when the shape of the question is clearer than the final query text.
Switch to SQL when you need to write or revise the statement directly. The two paths are useful for different stages of the same investigation: assemble the first pass visually, inspect the generated SQL, and refine the query when the question calls for it.
Before adding a chart, check the source, fields, joins, filters, and limit. A chart can make a result easier to read, but it does not establish that the selected data or query logic is correct.
Choose a chart type, assign an X field and one or more Y fields, then set the title, legend, display settings, and colors. Map-oriented chart configurations also expose map fields when that configuration is relevant.
The interactive gallery below renders public World Bank data as bar, line, area, pie, radar, and scatter charts. It demonstrates renderer output separately from the disabled product-interface preview above; it is not a live product connection or a statement of current picker availability.
The application registry includes more renderers than the standard chart picker exposes. Available chart choices depend on the interface and deployment; do not assume every registered renderer is directly selectable from the standard picker.
Dashboards / rendering gallery
This rendering gallery pairs compact SVG charts with USA annual indicators and a 2023 comparison across the United States, Canada, Mexico, and Brazil. Color is paired with direct labels, legends, and focusable marks.
World Bank public indicators · USA 2015–2023 · 2023 country comparison
GDP (current US$), population (people), and life expectancy at birth (years).
2023 GDP by country · current US$
Hover, tap, or focus a mark for its exact value.
USA GDP · current US$ · 2015–2023
Hover, tap, or focus a mark for its exact value.
USA population · people · 2015–2023
Hover, tap, or focus a mark for its exact value.
2023 population share · USA, CAN, MEX, BRA
Hover, tap, or focus a mark for its exact value.
USA 2023 profile · normalized to USA 2015–2023 maxima
Hover, tap, or focus a mark for its exact value.
2023 GDP vs life expectancy · circle size = population
Hover, tap, or focus a mark for its exact value.
Bundled snapshot retrieved 2026-09-02 is displayed while complete live observations load.
Source: World Bank ↗Add chart blocks alongside Markdown blocks to give a dashboard both a visual result and the written context needed to interpret it. A chart block can be edited, duplicated, refreshed, downloaded as CSV, or deleted from its available actions.
Dashboard blocks use a responsive 12-column layout. Move and resize blocks to make the main comparison visible first, keep related filters close to their charts, and preserve space for definitions or review notes. Layout changes persist in the application for the dashboard.
Layout is a presentation decision, not a substitute for query review. A clear grid can make it easier to compare related blocks, but it cannot resolve mismatched time windows, different grains, or incomplete source data.
Use a Markdown block to record the decision, source boundary, or caveat behind a chart. Chart takeaways provide a place to capture an observation, while comments are available when a chart dashboard block exists. These are review aids, not a claim of real-time collaborative editing or dashboard-level sharing.
When a result needs follow-up, reopen the chart configuration or query rather than treating a static takeaway as the final analysis. The chart, SQL, and block layout should remain inspectable together.
Dashboards / layout
A dashboard can combine chart and Markdown blocks in a responsive 12-column layout. Blocks can be moved and resized, with the resulting layout retained for the dashboard.
Chart block
Markdown block
Why the change matters
Use the release note and owner decision beside the chart so a number has working context.
Review the segment before changing the target.
Chart block
Chart block
Sample blocks and positions - no live dashboard changes
Typed dashboard variables can be defined for inputs that change between views. SQL-variable detection and mapping help connect those inputs to the query. Name variables clearly and check their type and mapping before relying on a filtered result.
Refresh controls include manual refresh and configurable auto-refresh intervals. An interval requests a refresh; it does not guarantee a specific cadence, source availability, query completion, or data freshness. Connection state, permissions, source behavior, and deployment affect the result.
Use manual refresh when you need to deliberately recheck a result. Use an interval when configured repetition is useful, then verify the returned data and timestamps in the context of the source before making a decision.
For recurring reviews, document the source, variable values, query assumptions, and expected time window beside the chart. Recheck those details when a dashboard changes shape or a result looks unexpected. Downloaded CSV output and an inspected SQL statement can help make a specific review reproducible.
The preview on this page is illustrative and has no live data connection or query execution. Use Dashboards with connections and permissions configured for the work you need to inspect.
Dashboards / variables and refresh
Define typed dashboard variables, then detect and map their SQL references. Refresh can be started manually or configured to run automatically; timing and data freshness still depend on the configured connection and deployment.
Configurable auto-refresh does not guarantee a refresh cadence or the freshness of returned data.
Variables
Illustrative configuration
| Name | Type | SQL mapping |
|---|---|---|
| region | Text | {{region}} |
| min_revenue | Number | {{min_revenue}} |
| report_date | Date | {{report_date}} |
WHERE region = {{region}}
AND revenue >= {{min_revenue}}
AND closed_at <= {{report_date}}Refresh
Manual or configurable automatic refresh
Chart discussion
Takeaways are available for charts.
Comments are available when the dashboard contains a chart block.
Sample configuration - no live data connection or query execution
Build and configure dashboards in Dashboards. For product guidance, read the visualization documentation.