Comparison Charts
Use bars or columns to compare groups such as regions. Start with one measure and a small number of categories; use a combination or KPI only when your question needs the extra measure or target.
Comparison charts
Section titled “Comparison charts”Interactive example
Comparison charts
Comparing multiple series across categories.
| Type | Best for | Required data and constraints |
|---|---|---|
groupedColumn | Comparing multiple series across categories. | Category, value, and one or more series; signed values are supported. |
stackedColumn | Comparing totals and their series contribution. | Category, value, and series; stacks signed values. |
normalizedColumn | Comparing percentage composition across categories. | Category, value, and series; normalizes each category to 100%. |
rangeColumn | Showing vertical low-to-high intervals. | Explicit low/high groups, with a shared channel or matched parallel channels; each high measure owns its axes. |
lollipop | A lighter single-series category ranking. | Category, value, and exactly one selected series. |
groupedBar | Category comparison when labels are long. | Category, value, and series; signed values are supported. |
stackedBar | Horizontal totals with composition. | Category, value, and series. |
normalizedBar | Horizontal percentage composition. | Category, value, and series; normalizes to 100%. |
rangeBar | Horizontal low-to-high intervals. | Explicit low/high groups with shared or matched parallel channels. |
Combination and KPI charts
Section titled “Combination and KPI charts”Interactive example
Combination and KPI charts
Comparing measures that benefit from column and line geometry.
| Type | Best for | Required data |
|---|---|---|
columnLine | Comparing measures that benefit from column and line geometry. | Category/value data with at least two series. |
areaLine | Comparing a filled magnitude with a trend. | Category/value data with at least two series. |
bullet | Actual versus target in a compact linear view. | One actual and one target measure. |
gauge | Actual versus target on a dial. | One actual and one target measure. |
kpi | A headline value with target and optional variance. | One actual, one target, and optionally one variance measure. |
progressGauge | Progress toward a target. | One actual and one target measure. |
linearGauge | Actual versus target on a horizontal or vertical track. | One actual and one target measure; authored limits and segmentation are optional. |
Both combination types also accept explicit bubble and histogram layers. See Cartesian sample layers for channel ownership, category/sample X identity, named axes, layer order and complete-bin semantics. This does not enable arbitrary chart-family composition.
Apply this type in code
Section titled “Apply this type in code”Switch from columns to bars and compare the same category totals. For a ready chart:
await chart.update({ chartType: 'groupedBar' });Next steps
Section titled “Next steps”See measures, formatting and chart chooser.