Column Chart

A column chart is a statistical chart that uses vertical bars to compare numerical values across different categories. The most basic column chart requires one categorical variable and one numerical variable. In a column chart, each entity of the categorical variable is represented as a rectangle (commonly called a "bar"), and the numerical value determines the height of the bar.

Use Cases

  • Column charts are best suited for comparing categorical data
  • Especially when values are close, since human perception of height is more accurate than other visual elements (such as area, angle, etc.), column charts are more appropriate

Visual Examples

2024 E-commerce Monthly GMV

Six-Country GDP Growth Comparison, Custom Colors

Quarterly Expenditure by Department, Custom Palette

Options

Configuration Options

PropertyTypeRequiredDescription
typestringrequiredValue must be "column".
dataObject[]requiredChart data.
data.categorystringrequiredCategory name.
data.valuenumberrequiredData value.
data.groupstringoptionalGroup name. Required when grouping or stacking is enabled.
groupbooleanoptionalWhether to enable grouping.
stackbooleanoptionalWhether to enable stacking.
titlestringoptionalChart title.
axisXTitlestringoptionalX-axis title.
axisYTitlestringoptionalY-axis title.
theme'default' | 'dark' | 'academy'optionalChart theme, default is "default".
styleObjectoptionalChart style.
style.backgroundColorstringoptionalMust be a valid color value.
style.palettestring[]optionalMust be an array of valid color values.