Back to Cube

Charts

docs-mintlify/docs/explore-analyze/charts/index.mdx

1.6.432.6 KB
Original Source

Every tab in a Cube workbook has a chart panel. Once your query returns results, switch to the chart panel to pick a visualization type and configure how the data is displayed — from a simple bar chart to a composable KPI tile or a fully custom Vega-Lite spec.

Chart types

Cube has built-in support for bar, line, area, pie, scatter, heatmap, KPI, map, boxplot, and more. See the chart types overview for a full list and guidance on which type fits which data shape.

Selecting a chart type

Chart type icons at the top of the chart panel let you quickly switch between common layouts — grouped vs. stacked bars, line vs. area, table vs. chart view — without opening the full configuration panel.

Cube automatically picks a chart type when you run a new query. Any manual configuration you apply is preserved when you change query fields.

Resetting chart settings

To discard your configuration and let Cube re-select a chart type based on the current query, open the tab options menu and choose Reset chart.

Generate charts with AI

Describe the visualization you want in plain language — for example, "show this as a stacked bar grouped by status" — and the AI agent will build and configure it. You can also let the agent auto-suggest the best chart for your query results.

Charts generated by the AI are written as Vega-Lite v5 specs and can be further edited in the custom visualization spec editor.

Configure charts

Adjust the appearance of any chart through the configuration panel:

  • Color and stacking — Color palettes, series coloring, and stacking behavior
  • Series configuration — Per-series mark type, color, and display options
  • Series mapping — Assign query fields to chart channels (X, Y, color, size)
  • Axes — Axis titles, grid lines, scale, and reference lines
  • Tooltips — Fields shown on hover
  • Data labels — Values displayed directly on chart marks

Custom visualizations

When the built-in chart types don't cover your use case, write a raw Vega-Lite spec or use an HTML template with Handlebars. Both options give you complete control over the rendered output.