Before you begin
You need a chart backed by query results and permission to edit it. For a dashboard, open More options → Edit manually, then use the chart’s menu to open its customization controls.Customize a chart
- Choose a chart type suited to the comparison: a line for change over time, a bar for categories, or a scatter plot for a relationship between measures.
- Check which fields supply the axes and series.
- Set a clear title, labels, units, and legend.
- Review the preview, save the widget changes, then save the dashboard.
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.
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.