Skip to main content
Column and bar charts are excellent for comparing discrete categories of data. Column charts display vertical bars, while bar charts display horizontal bars.

Column Charts

Column charts display one column per value along an X axis, making them ideal for comparing values across categories.

Basic Column Chart

Column Chart Configuration

Key configuration options from ~/workspace/source/ts/Series/Column/ColumnSeriesDefaults.ts:45-406:
number | string
default:"3"
The corner radius of the border surrounding each column. Can be a number (pixels) or percentage string.
number
The width of the border surrounding each column. Defaults to 1 when there is room, but 0 when columns are dense.
number
default:"0.2"
Padding between each value group, in x axis units.
number
default:"0.1"
Padding between each column or bar, in x axis units.
number
A pixel value specifying a fixed width for each column. When undefined, width is calculated from pointPadding and groupPadding.
number
The maximum allowed pixel width for a column. Prevents columns from becoming too wide with few data points.
number
default:"0"
The minimal height for a column. By default, 0 values are not shown. Set to a pixel value like 3 to visualize near-zero points.
boolean
default:"false"
When true, each column receives a different color from the colors array.

Stacked Column Chart

Bar Charts

Bar charts are simply column charts rotated 90 degrees, displaying horizontal bars instead of vertical columns.

Basic Bar Chart

Bar charts use the same configuration options as column charts. Simply change chart.type to ‘bar’.

Advanced Column Types

Column Range

Display ranges with a low and high value for each point.

Waterfall Chart

Show how an initial value is affected by intermediate positive or negative values.

Data Labels and Styling

Use Cases

Column Charts

  • Comparing values across categories
  • Showing changes over time
  • Displaying frequency distributions
  • Budget vs. actual comparisons

Bar Charts

  • Ranking items
  • Long category names
  • Comparing many categories
  • Survey results

Data Formats

Column and bar charts support these data formats:
  1. Array of numbers: data: [0, 5, 3, 5]
  2. Array of arrays: data: [[0, 6], [1, 2], [2, 6]]
  3. Array of objects: data: [{x: 1, y: 9, name: "Point2", color: "#00FF00"}]
When using colorByPoint: true, each point gets a different color, which may not be suitable for all use cases.