Skip to content
DocsChartsStacked barsLast updated Nov 2, 2026

Stacked bars

The total per period, and what it is made of. Sample data: failed payments per week by reason (card declined, insufficient funds, fraud block), W27 to W40.

Open in
Failed payments by reasonFailed payments per week by reason, W27 to W40: 552 in W27, 214 in W40 (118 card declined, 64 insufficient funds, 32 fraud block).6004002000W27W30W33W36W40CARD DECLINEDINSUFFICIENT FUNDSFRAUD BLOCK
Failed payments by reason
WeekCard declinedInsufficient fundsFraud blockTotal
W2730416682552
W2829616181538
W2929816281541
W3027915276507
W3126914773489
W3226214371476
W3324913667452
W3423712965431
W3521911960398
W3618810351342
W371719347311
W381528341276
W391367437247
W401186432214
Failed payments by reasonFailed payments per week by reason, W27 to W40: 552 in W27, 214 in W40 (118 card declined, 64 insufficient funds, 32 fraud block).6004002000W27W30W33W36W40CARD DECLINEDINSUFFICIENT FUNDSFRAUD BLOCK
Failed payments by reason
WeekCard declinedInsufficient fundsFraud blockTotal
W2730416682552
W2829616181538
W2929816281541
W3027915276507
W3126914773489
W3226214371476
W3324913667452
W3423712965431
W3521911960398
W3618810351342
W371719347311
W381528341276
W391367437247
W401186432214

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 Stacked bars component to your project.

    npx shadcn add @chartory/stacked-bars
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { StackedBars }  from "@/components/chartory/stacked-bars"<StackedBars  data={failuresByReason}  size="m"  legend/>

Props

<StackedBars>

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.StackedBarsDataRequired
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

StackedBarsData

The data prop: one object for the whole chart.

PropTypeDefault
max: The top of the value scale.numberRequired
ticks: The axis tick labels.string[]Required
labels: The labels, by index.Record<number, string>Required
ratio?: The gap between bars, as a share of the band.number0.2
stacks: One entry per stacked part.StackedBarsStack[]Required

StackedBarsStack

One object per entry in stacks.

PropTypeDefault
name: The name shown on the chart.stringRequired
tok: The colour token, e.g. "data/primary".stringRequired
vals: The values, in order.number[]Required

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

Stacked bar chart: a React and Figma chart in four sizes

What does a stacked bar chart show?

A stacked bar chart builds each bar from its parts, so you read the total and the mix in one shape. Use it for failures by reason, revenue by plan or tickets by type, period after period.

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 Stacked bars component?

It is one <StackedBars> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is two to four parts per 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?

  • Does the total per period matter? Yes means the stacked bars fit.
  • Are there several periods? Yes means the stacked bars fit.
  • Are there four parts or fewer? Yes means the stacked bars fit.

When does another type fit better?

  • Parts compared with each other. Use Grouped bars instead.
  • One split, one moment. Use Donut instead.
  • Many parts in a flowing mix. Use Streamgraph instead.

Stacked bar 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.