Skip to content
DocsChartsBarsLast updated Nov 2, 2026

Bars

One value per item, side by side. Sample data: monthly company card spend, January to September, 71K in July, September month to date.

Open in
Monthly card spendCard spend by month, January to September, in $K. September (month to date) is 40K; the highest month is July at 71K.48KJAN52KFEB61KMAR57KAPR66KMAY59KJUN71KJUL68KAUG40KSEPMONTH TO DATECLOSED MONTHS
Monthly card spend
MonthSpend
JAN$48K
FEB$52K
MAR$61K
APR$57K
MAY$66K
JUN$59K
JUL$71K
AUG$68K
SEP$40K
Monthly card spendCard spend by month, January to September, in $K. September (month to date) is 40K; the highest month is July at 71K.48KJAN52K61KMAR57K66KMAY59K71KJUL68K40KSEPMONTH TO DATECLOSED MONTHS
Monthly card spend
MonthSpend
JAN$48K
FEB$52K
MAR$61K
APR$57K
MAY$66K
JUN$59K
JUL$71K
AUG$68K
SEP$40K

Installation

  1. 1

    Set up the registry once

    This chart is free in Hearth and MIT licensed: no token. Add @chartory to components.json once (the URL alone, no headers), or skip this when another chart is already installed.

    Installation guide
  2. 2

    Add the chart

    One command adds the Bars component to your project.

    npx shadcn add @chartory/bars
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { Bars }  from "@/components/chartory/bars"<Bars  data={cardSpend}  size="m"  legend/>

Props

<Bars>

Every prop but data is a Figma property with the same name and values.

PropTypeDefault
data: The chart's data. The tables below list every field.BarsDataRequired
size: The size class. Each one is laid out again from the data."xs" | "s" | "m" | "l""m"
legend: Shows the legend row under the plot.booleantrue
color: The data colour of the primary marks (data/primary)."cat-1" | "cat-2" | "cat-3" | "cat-4""cat-1"

BarsData

The data prop: one object for the whole chart.

PropTypeDefault
cats: The category labels, in order.string[]Required
vals: The values, in order.number[]Required
toks: The colour token of each item, in order.string[]Required
max: The top of the value scale.numberRequired
shape: The bar ends."pill" | "top"Required
inside: How the value labels sit in the bars."rot" | "flat"Required
ratio?: The gap between bars, as a share of the band.number0.25
fmt: Formats a value for its label.(v: number) => stringRequired
ref?: A reference line: value, label and colour.BarsRef—

BarsRef

The ref object.

PropTypeDefault
v: The value.numberRequired
label: The name shown on the chart.stringRequired
tok: The colour token, e.g. "data/primary".stringRequired

The data as a JSON Schema: schemas/bars.json

Bar chart: a React and Figma chart in four sizes

What does a bar chart show?

A bar chart gives each item or period one bar from zero, so the tallest and shortest stand out at once. It is the safest way to compare amounts. Use it for monthly totals, counts per category and any values people want to rank by eye.

Chartory ships it as a Figma component and a React component with the same name. The code installs from the shadcn registry with one command and lands in your project as a file you own.

What is the Bars component?

It is one <Bars> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is one value per item or period.

Sizes XS, S, M and L re-lay the chart out from the data instead of scaling it, so labels stay readable at every size.

When should I use it?

  • Is each bar its own amount? Yes means the bars fit.
  • Is there one series? Yes means the bars fit.
  • Are the labels short? Yes means the bars fit.

When does another type fit better?

  • The parts make up one whole. Use Stacked bars instead.
  • Several series per period. Use Grouped bars instead.
  • Long names need room. Use Horizontal bars instead.

Bar chart questions

Installing, data, Figma and plans.

  • Yes. It installs through the shadcn registry with the shadcn CLI, and the file lands in your project.

Stay in the loop

New charts, by email.

Get an email when new chart types and releases ship.

Unsubscribe any time.