Dashboard widget reference
The chart picker contains 106 tiles — 40 standard widgets and 66 specialized widgets. This reference covers each tile by its name in Add widget, including the specialized charts used in the Tableau-inspired example dashboards. You can add these widgets yourself, change their data, style them and configure supported interactions in the editor.
Start with Build and publish a revenue dashboard for a complete workflow. Use the family pages below when you need a particular data shape or visual layout. Every widget entry includes a screenshot of the real Studio renderer using fictional sample data. Select a screenshot to view it at full size.
| Reference | What it covers |
|---|---|
| KPIs and gauges | Metrics, sparklines, period comparisons, status, proportions and carbon clocks |
| Trends and calendars | Wide and grouped series, calendars, dual-axis views, candlesticks and Gantt charts |
| Category comparisons | Bars, shares, rankings, funnels, targets and profile breakdowns |
| Distributions and matrices | Scatter, bubbles, box plots, histograms, radar and cell comparisons |
| Tables, hierarchies and flows | Tables, trees, treemaps, Sankey flows, profiles and insight panels |
| Maps and geographic views | Points, filled areas, routes, GeoJSON and image-based maps |
| Text and canvas controls | Text, uploaded logos, navigation, filters and palette swatches |
| ML views and Custom JS | Existing model output and hosted visualization plugins |
A specialized widget is a built-in chart or layout selected from the picker, with starter data, field mappings and editable settings. It needs no custom code. The picker groups these under Custom charts. Custom JS is a separate plugin widget whose renderer is supplied by its author.
Add a widget from scratch
- Open the workbook, enter Edit dashboard and choose Add widget. Search by the tile name from the catalog below.
- Select the tile. Specialized widgets load the specialized view, starter mappings and example data query together. They are starting points that you can edit, rather than a separate set of read-only template charts.
- Choose Visual query, a saved Dataset, a published flow dataset or Custom SQL. For production dashboards, use your own persisted tables, views or governed datasets.
- Preview the result. Check its row grain, column names, types and totals against the reference entry. Bind the fields using the relevant chart controls. If you rename a field, update every mapping that uses it.
- Set presentation and interaction options, save, and test in view mode. Repeat in presentation view before publishing.
Editing an existing widget may restrict changes to its base visualization type. Add the desired picker tile when changing to a different chart family, then bind the same dataset.
Data and field mapping
Each entry describes required fields for its starter mapping, optional bindings, an example result, styling and supported interactions. Names such as value and category are example names. Explicit field controls can bind your own names. Positional standard renderers still depend on column order.
| Shape | Example | Use it for |
|---|---|---|
| Single summary row | value, previous | Headline KPI or gauge |
| Wide series | month, actual, forecast | Standard Line/Area and metric comparison |
| Long series | period, segment, value | Grouped time series and stacked presets |
| Category summary | category, value, target | Rankings, shares and comparisons |
| Raw observations | category, value, many rows per category | Grouped box plot |
| Path or edge | source, target, value | Flows and relationships |
| Geographic features | id, name, longitude, latitude, value | Point map with stable-key selection |
Preview numeric fields as numbers, rather than formatted strings such as $1,200. Apply currency symbols, separators and units in the format controls. Fractional percent format turns 0.72 into 72%. A value of 72 would become 7,200%. Use a percent suffix instead when the source already returns percentage points.
Order time-series rows deliberately. Aggregate duplicate category, period or hierarchy keys to the intended grain. Do not join two detail tables and sum the resulting duplicates. For a rate, aggregate its numerator and denominator before dividing. Missing observations, unavailable ratios and zero values have different meanings.
Use the examples
Every data tile has a complete downloadable SQL example. The files use fictional literal rows, so they do not require existing tables. They demonstrate the result shape and can be previewed through a running warehouse. You can produce the same columns with the visual builder without writing SQL.
The files have been checked for column names and result shape. They are not a claim that every renderer or deployment has been exercised against a live engine. Some examples repeat the same shape across several presets because the preset settings determine the presentation.
The Table and Custom JS examples replace the picker's your_table placeholder with self-contained data. The standard Map example explicitly names longitude, latitude, value and name to make its bindings clear. Text and canvas controls have setup examples instead of queries.
Shared styling controls
Use the normal controls in the widget editor. The relevant controls depend on the tile and selected view. Open All chart settings for additional typed controls when available. A setting exposed for one view may not apply to another renderer.
| Controls | What to configure |
|---|---|
| Title and description | A readable name, measurement period, units and useful context |
| Frame | Background color or transparency, border, padding, title/footer visibility and font family |
| Number format | Number, currency or fraction-based percent, decimals, compact notation, prefix and suffix |
| Colors | Theme palette, category colors, supported series colors and selected-state styling |
| Axes | Titles, label size/rotation, minimum, maximum, interval, visibility and value format where supported |
| Series | Supported line/bar/area choices, colors, points, stacking and labels for the selected renderer |
| Metric text | Title and value size, horizontal alignment, bold, italic, underline and comparison presentation |
| View-specific options | Hierarchy levels, stages, table columns, map geometry, comparison periods and other bindings described in each entry |
Metric title controls support larger titles as well as bold and italic styling. Background sparkline, split-trend and benchmark-panel presets produce different KPI layouts. Page background, text panel transparency and borderless frames let you compose a Udemy-style canvas. Clock geometry, labels, track colors and frame styling support a dark Climate-style header and carbon-clock section.
Resize widgets for their actual content. A ranking needs height for its rows, a calendar needs legible cells, and a clock needs room for country labels. Label clipping is not proof that the source returned fewer rows. Compare the preview and Show data table before changing the query.
Filters, actions and drill-through
There are three distinct interactions to configure.
| Interaction | What it does | What you must check |
|---|---|---|
| Local chart control | Changes visible series, top N, page, hierarchy expansion or selected metric | Whether the control updates only this widget or is explicitly bound to a dashboard filter |
| Dashboard filter | Supplies a named value to receiving widget recipes or queries | Filter name, type, scope and the receiving condition’s Dashboard filter binding |
| Mark action / drill-through | Sends a clicked category or key to a filter or target dashboard | Renderer support, source key, target, permissions and expected selection value |
Configure interactions through the widget's filter/action and drill controls. Use a stable key when display names can repeat. The action scope can target a page or workbook as supported by its configuration. Receiving visual recipes need an actual condition bound to the corresponding dashboard filter. A visible filter chip alone does not prove that a widget uses it.
Mark actions run in view and presentation modes. Edit mode reserves gestures for editing. Supported charts can use automatic cross-filtering with the first result column as the default dimension. Set an explicit action when the displayed mark represents another field, and disable automatic cross-filtering when a chart is for exploration only. Selecting the same active value can clear a filter selection.
Support differs by renderer. An action control being visible in the editor does not guarantee that a particular plot sends clicks. Each entry states its supported mark behavior and, where useful, points to a selectable alternative. A gauge or plain text panel does not become selectable merely because another chart is selectable. KPI whole-card actions need an explicit action field in the first result row.
For a map, a feature ID must match the receiving filter’s ID, not an unrelated display name. For a matrix, configure a stable cell selection key if its default combined coordinate key is unsuitable. For a calendar, date and month selections have different values. For hierarchy charts, select the intended level and field. A drill target still enforces dashboard and data access permissions.
See Layout, filters, and interactions for filter placement and page composition.
Check a widget before publishing
- Compare a known total, category and period with the source. Verify the full result in Show data table, not just the displayed top N or first page.
- Check empty results, missing values, zero denominators and long labels. A ratio without a valid denominator must not become a false zero.
- Exercise every configured selection, reset, metric selector and drill target. Confirm that receiving widgets change and that clearing the selection restores the expected population.
- Review standard and presentation views at the intended screen size. Verify title, value, axes, legends, background and focus visibility. Refresh, data-table and fullscreen controls appear on hover or keyboard focus in view mode.
- Reload after saving and repeat the key interaction. Publish and check the viewer experience with the intended access.
A warehouse that is starting can delay previews and refreshes. Wait for the startup/waiting status to clear before diagnosing an empty chart as a data-shape problem. For sharing, continue with Publish and share a dashboard.
Complete picker index
Names below match Add widget. The kind distinguishes standard tiles from specialized widgets, including presets that share a base renderer.
| Picker tile | Kind | Reference family |
|---|---|---|
| Actual vs target | Specialized widget | Category comparisons |
| Area | Standard | Trends and calendars |
| Asset profile | Specialized widget | Tables, hierarchies and flows |
| Background sparkline KPI | Specialized widget | KPIs and gauges |
| Banded facts | Specialized widget | Tables, hierarchies and flows |
| Bar | Standard | Category comparisons |
| Bar and marker comparison | Specialized widget | Category comparisons |
| Bar Race | Standard | Category comparisons |
| Benchmark trend KPI | Specialized widget | KPIs and gauges |
| Boxplot | Standard | Distributions and matrices |
| Bubble matrix | Specialized widget | Distributions and matrices |
| Bullet | Standard | Category comparisons |
| Calendar | Standard | Trends and calendars |
| Calendar comparison KPI | Specialized widget | KPIs and gauges |
| Calendar metric scatterplot | Specialized widget | Distributions and matrices |
| Calendar with daily detail | Specialized widget | Trends and calendars |
| Candlestick | Standard | Trends and calendars |
| Canvas filters | Specialized widget | Text and canvas controls |
| Canvas navigation | Specialized widget | Text and canvas controls |
| Carbon clock | Specialized widget | KPIs and gauges |
| Choropleth | Standard | Maps and geographic views |
| Color palette samples | Specialized widget | Text and canvas controls |
| Combo | Standard | Trends and calendars |
| Comparison bars | Specialized widget | Category comparisons |
| Comparison radar | Specialized widget | Distributions and matrices |
| Composition KPI | Specialized widget | KPIs and gauges |
| Conversion funnel | Specialized widget | Category comparisons |
| Custom JS | Standard | ML views and Custom JS |
| Date-range comparison KPI | Specialized widget | KPIs and gauges |
| Donut | Standard | Category comparisons |
| Dual-axis metric comparison | Specialized widget | Trends and calendars |
| Expandable hierarchy | Specialized widget | Tables, hierarchies and flows |
| Feature Importance | Standard | ML views and Custom JS |
| Filled area map | Specialized widget | Maps and geographic views |
| Funnel | Standard | Category comparisons |
| Gantt | Standard | Trends and calendars |
| Gauge | Standard | KPIs and gauges |
| Geographic point map | Specialized widget | Maps and geographic views |
| GeoJSON area map | Specialized widget | Maps and geographic views |
| GeoJSON shape gallery | Specialized widget | Maps and geographic views |
| Graph | Standard | Tables, hierarchies and flows |
| Grouped / stacked bars | Specialized widget | Trends and calendars |
| Grouped box plot | Specialized widget | Distributions and matrices |
| Grouped time series | Specialized widget | Trends and calendars |
| Heatmap | Standard | Distributions and matrices |
| Heatmap matrix | Specialized widget | Distributions and matrices |
| Hierarchy ring | Specialized widget | Tables, hierarchies and flows |
| Hierarchy treemap | Specialized widget | Tables, hierarchies and flows |
| Histogram | Standard | Distributions and matrices |
| Illustrated map | Specialized widget | Maps and geographic views |
| Indexed time series | Specialized widget | Trends and calendars |
| Insight callout | Specialized widget | Tables, hierarchies and flows |
| Insight cards | Specialized widget | Tables, hierarchies and flows |
| Line | Standard | Trends and calendars |
| Lines (Geo) | Standard | Maps and geographic views |
| Logo panel | Specialized widget | Text and canvas controls |
| Map | Standard | Maps and geographic views |
| Metric | Standard | KPIs and gauges |
| Metric bubbles | Specialized widget | Distributions and matrices |
| ML Anomaly | Standard | ML views and Custom JS |
| ML Forecast | Standard | ML views and Custom JS |
| Monthly calendar heatmap | Specialized widget | Trends and calendars |
| Multi-measure comparison | Specialized widget | Category comparisons |
| Multi-stage flow | Specialized widget | Tables, hierarchies and flows |
| Packed Bubbles | Standard | Distributions and matrices |
| Paginated ranking | Specialized widget | Category comparisons |
| Paired comparison | Specialized widget | Category comparisons |
| Parallel | Standard | Distributions and matrices |
| Period hierarchy table | Specialized widget | Tables, hierarchies and flows |
| Period summary KPI | Specialized widget | KPIs and gauges |
| Pictorial Bar | Standard | Category comparisons |
| Pie | Standard | Category comparisons |
| Polar Bar | Standard | Category comparisons |
| Predicted vs Actual | Standard | ML views and Custom JS |
| Profile breakdown | Specialized widget | Category comparisons |
| Proportion marker KPI | Specialized widget | KPIs and gauges |
| Proportion ring KPI | Specialized widget | KPIs and gauges |
| Radar | Standard | Distributions and matrices |
| Radial carbon clock | Specialized widget | KPIs and gauges |
| Ranked shares | Specialized widget | Category comparisons |
| Ranking with summary | Specialized widget | Category comparisons |
| Reference-year KPI | Specialized widget | KPIs and gauges |
| Sankey | Standard | Tables, hierarchies and flows |
| Scatter | Standard | Distributions and matrices |
| Secondary value KPI | Specialized widget | KPIs and gauges |
| Selectable daily calendar | Specialized widget | Trends and calendars |
| Selectable flow | Specialized widget | Tables, hierarchies and flows |
| Semicircle gauge | Specialized widget | KPIs and gauges |
| Share donut | Specialized widget | Category comparisons |
| Spiral gauge | Specialized widget | KPIs and gauges |
| Split trend KPI | Specialized widget | KPIs and gauges |
| Stacked area series | Specialized widget | Trends and calendars |
| Status KPI | Specialized widget | KPIs and gauges |
| Stepped time series | Specialized widget | Trends and calendars |
| Street point map | Specialized widget | Maps and geographic views |
| Sunburst | Standard | Tables, hierarchies and flows |
| Table | Standard | Tables, hierarchies and flows |
| Text | Standard | Text and canvas controls |
| Theme River | Standard | Trends and calendars |
| Tree | Standard | Tables, hierarchies and flows |
| Treemap | Standard | Tables, hierarchies and flows |
| Trend comparison grid | Specialized widget | Trends and calendars |
| Utilization rings | Specialized widget | KPIs and gauges |
| Waterfall | Standard | Category comparisons |
| Weather cards | Specialized widget | Tables, hierarchies and flows |
| Weighted distribution | Specialized widget | Distributions and matrices |