Skip to main content
The Chart widget visualises query results as interactive graphics. A single query can drive any of 25+ chart types — changing the chart type never requires rewriting the query.

Reading the data

Supaboard maps query columns to chart dimensions automatically:
  • The first non-numeric column becomes the X-axis (categories or time values).
  • Numeric columns become series on the Y-axis.
  • For charts that need a third dimension (bubble, scatter, heatmap), a second non-numeric column becomes the grouping field.
If the automatic mapping doesn’t match your intent, use the X-axis → Axis and Y-axis field selectors in the settings panel to override it. Null values in numeric columns are treated as gaps in line and area charts, and as zero in bar and column charts.

Chart types

Select a chart type from the Chart type picker in the settings panel.

Trend over time

Part-to-whole

Comparison

Distribution and correlation

Specialised

Basic settings

These settings apply to all chart types.

X-axis

Controls the horizontal axis (or the category axis for horizontal bar charts).

Time-based X-axis

When your X-axis contains dates or timestamps, enable Timestamp mode to unlock:

Custom range

Y-axis

Controls the vertical axis (or the value axis for horizontal bar charts).

Value formatting

Y-axis tick labels can be formatted independently of the raw data:

Dual axis

For multi-series charts (line, bar, column, combo), a second Y-axis can be added to plot series with different units or scales on the same chart.

Series colors

Each series has a color swatch in the settings panel. Click any swatch to open a color picker and assign a custom hex color to that series. Colors are saved per-series by name — if the query returns the same column name on the next refresh, it retains its color.

Data point labels

Show the actual value on each data point or bar. Available for bar, column, pie, donut, area, bubble, scatter, and radar charts. Labels can be configured per series — expand a specific series under Data points → Series to override the global settings for that series only.

Grid lines and goal line

Grid lines

Goal line

A goal line draws a horizontal reference line across the chart at a specific value — useful for targets, SLAs, or budgets.

Legend

Clicking a legend item in view mode toggles that series on and off interactively — this is a viewer-side interaction and does not change the saved configuration.

Data zoom

Data zoom adds a scrollable range slider below the chart, letting viewers pan and zoom into a subset of the data without changing the query. Available on all chart types except funnel and radar. Toggle it under Settings → Data zoom.

Pie and donut options

In addition to the standard chart settings, pie and donut charts have:

Center total (donut only)

Percentage labels

Last modified on March 11, 2026