Skip to main content

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.

ReferenceWhat it covers
KPIs and gaugesMetrics, sparklines, period comparisons, status, proportions and carbon clocks
Trends and calendarsWide and grouped series, calendars, dual-axis views, candlesticks and Gantt charts
Category comparisonsBars, shares, rankings, funnels, targets and profile breakdowns
Distributions and matricesScatter, bubbles, box plots, histograms, radar and cell comparisons
Tables, hierarchies and flowsTables, trees, treemaps, Sankey flows, profiles and insight panels
Maps and geographic viewsPoints, filled areas, routes, GeoJSON and image-based maps
Text and canvas controlsText, uploaded logos, navigation, filters and palette swatches
ML views and Custom JSExisting 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​

  1. Open the workbook, enter Edit dashboard and choose Add widget. Search by the tile name from the catalog below.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

ShapeExampleUse it for
Single summary rowvalue, previousHeadline KPI or gauge
Wide seriesmonth, actual, forecastStandard Line/Area and metric comparison
Long seriesperiod, segment, valueGrouped time series and stacked presets
Category summarycategory, value, targetRankings, shares and comparisons
Raw observationscategory, value, many rows per categoryGrouped box plot
Path or edgesource, target, valueFlows and relationships
Geographic featuresid, name, longitude, latitude, valuePoint 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.

ControlsWhat to configure
Title and descriptionA readable name, measurement period, units and useful context
FrameBackground color or transparency, border, padding, title/footer visibility and font family
Number formatNumber, currency or fraction-based percent, decimals, compact notation, prefix and suffix
ColorsTheme palette, category colors, supported series colors and selected-state styling
AxesTitles, label size/rotation, minimum, maximum, interval, visibility and value format where supported
SeriesSupported line/bar/area choices, colors, points, stacking and labels for the selected renderer
Metric textTitle and value size, horizontal alignment, bold, italic, underline and comparison presentation
View-specific optionsHierarchy 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.

InteractionWhat it doesWhat you must check
Local chart controlChanges visible series, top N, page, hierarchy expansion or selected metricWhether the control updates only this widget or is explicitly bound to a dashboard filter
Dashboard filterSupplies a named value to receiving widget recipes or queriesFilter name, type, scope and the receiving condition’s Dashboard filter binding
Mark action / drill-throughSends a clicked category or key to a filter or target dashboardRenderer 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​

  1. 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.
  2. Check empty results, missing values, zero denominators and long labels. A ratio without a valid denominator must not become a false zero.
  3. Exercise every configured selection, reset, metric selector and drill target. Confirm that receiving widgets change and that clearing the selection restores the expected population.
  4. 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.
  5. 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 tileKindReference family
Actual vs targetSpecialized widgetCategory comparisons
AreaStandardTrends and calendars
Asset profileSpecialized widgetTables, hierarchies and flows
Background sparkline KPISpecialized widgetKPIs and gauges
Banded factsSpecialized widgetTables, hierarchies and flows
BarStandardCategory comparisons
Bar and marker comparisonSpecialized widgetCategory comparisons
Bar RaceStandardCategory comparisons
Benchmark trend KPISpecialized widgetKPIs and gauges
BoxplotStandardDistributions and matrices
Bubble matrixSpecialized widgetDistributions and matrices
BulletStandardCategory comparisons
CalendarStandardTrends and calendars
Calendar comparison KPISpecialized widgetKPIs and gauges
Calendar metric scatterplotSpecialized widgetDistributions and matrices
Calendar with daily detailSpecialized widgetTrends and calendars
CandlestickStandardTrends and calendars
Canvas filtersSpecialized widgetText and canvas controls
Canvas navigationSpecialized widgetText and canvas controls
Carbon clockSpecialized widgetKPIs and gauges
ChoroplethStandardMaps and geographic views
Color palette samplesSpecialized widgetText and canvas controls
ComboStandardTrends and calendars
Comparison barsSpecialized widgetCategory comparisons
Comparison radarSpecialized widgetDistributions and matrices
Composition KPISpecialized widgetKPIs and gauges
Conversion funnelSpecialized widgetCategory comparisons
Custom JSStandardML views and Custom JS
Date-range comparison KPISpecialized widgetKPIs and gauges
DonutStandardCategory comparisons
Dual-axis metric comparisonSpecialized widgetTrends and calendars
Expandable hierarchySpecialized widgetTables, hierarchies and flows
Feature ImportanceStandardML views and Custom JS
Filled area mapSpecialized widgetMaps and geographic views
FunnelStandardCategory comparisons
GanttStandardTrends and calendars
GaugeStandardKPIs and gauges
Geographic point mapSpecialized widgetMaps and geographic views
GeoJSON area mapSpecialized widgetMaps and geographic views
GeoJSON shape gallerySpecialized widgetMaps and geographic views
GraphStandardTables, hierarchies and flows
Grouped / stacked barsSpecialized widgetTrends and calendars
Grouped box plotSpecialized widgetDistributions and matrices
Grouped time seriesSpecialized widgetTrends and calendars
HeatmapStandardDistributions and matrices
Heatmap matrixSpecialized widgetDistributions and matrices
Hierarchy ringSpecialized widgetTables, hierarchies and flows
Hierarchy treemapSpecialized widgetTables, hierarchies and flows
HistogramStandardDistributions and matrices
Illustrated mapSpecialized widgetMaps and geographic views
Indexed time seriesSpecialized widgetTrends and calendars
Insight calloutSpecialized widgetTables, hierarchies and flows
Insight cardsSpecialized widgetTables, hierarchies and flows
LineStandardTrends and calendars
Lines (Geo)StandardMaps and geographic views
Logo panelSpecialized widgetText and canvas controls
MapStandardMaps and geographic views
MetricStandardKPIs and gauges
Metric bubblesSpecialized widgetDistributions and matrices
ML AnomalyStandardML views and Custom JS
ML ForecastStandardML views and Custom JS
Monthly calendar heatmapSpecialized widgetTrends and calendars
Multi-measure comparisonSpecialized widgetCategory comparisons
Multi-stage flowSpecialized widgetTables, hierarchies and flows
Packed BubblesStandardDistributions and matrices
Paginated rankingSpecialized widgetCategory comparisons
Paired comparisonSpecialized widgetCategory comparisons
ParallelStandardDistributions and matrices
Period hierarchy tableSpecialized widgetTables, hierarchies and flows
Period summary KPISpecialized widgetKPIs and gauges
Pictorial BarStandardCategory comparisons
PieStandardCategory comparisons
Polar BarStandardCategory comparisons
Predicted vs ActualStandardML views and Custom JS
Profile breakdownSpecialized widgetCategory comparisons
Proportion marker KPISpecialized widgetKPIs and gauges
Proportion ring KPISpecialized widgetKPIs and gauges
RadarStandardDistributions and matrices
Radial carbon clockSpecialized widgetKPIs and gauges
Ranked sharesSpecialized widgetCategory comparisons
Ranking with summarySpecialized widgetCategory comparisons
Reference-year KPISpecialized widgetKPIs and gauges
SankeyStandardTables, hierarchies and flows
ScatterStandardDistributions and matrices
Secondary value KPISpecialized widgetKPIs and gauges
Selectable daily calendarSpecialized widgetTrends and calendars
Selectable flowSpecialized widgetTables, hierarchies and flows
Semicircle gaugeSpecialized widgetKPIs and gauges
Share donutSpecialized widgetCategory comparisons
Spiral gaugeSpecialized widgetKPIs and gauges
Split trend KPISpecialized widgetKPIs and gauges
Stacked area seriesSpecialized widgetTrends and calendars
Status KPISpecialized widgetKPIs and gauges
Stepped time seriesSpecialized widgetTrends and calendars
Street point mapSpecialized widgetMaps and geographic views
SunburstStandardTables, hierarchies and flows
TableStandardTables, hierarchies and flows
TextStandardText and canvas controls
Theme RiverStandardTrends and calendars
TreeStandardTables, hierarchies and flows
TreemapStandardTables, hierarchies and flows
Trend comparison gridSpecialized widgetTrends and calendars
Utilization ringsSpecialized widgetKPIs and gauges
WaterfallStandardCategory comparisons
Weather cardsSpecialized widgetTables, hierarchies and flows
Weighted distributionSpecialized widgetDistributions and matrices