Skip to content
DocsChartsAge pyramidLast updated Nov 2, 2026

Age pyramid

Two groups by age, back to back. Sample data: active customers by age, new against returning, 25–34 at 28% and 24%.

Open in
Customers by ageShare of new and returning customers by age band: 25–34 is the largest new band (28%), 35–44 the largest returning band (27%).18–2414%8%25–3428%24%35–4424%27%45–5417%20%55–6411%14%65+6%7%NEWRETURNING
Customers by age
AgeNew (%)Returning (%)
18–24148
25–342824
35–442427
45–541720
55–641114
65+67
Customers by ageShare of new and returning customers by age band: 25–34 is the largest new band (28%), 35–44 the largest returning band (27%).18–2414%8%25–3428%24%35–4424%27%45–5417%20%55–6411%14%65+6%7%NEWRETURNING
Customers by age
AgeNew (%)Returning (%)
18–24148
25–342824
35–442427
45–541720
55–641114
65+67

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 Age pyramid component to your project.

    npx shadcn add @chartory/age-pyramid
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { AgePyramid }  from "@/components/chartory/age-pyramid"<AgePyramid  data={customerAges}  size="m"  legend/>

Props

<AgePyramid>

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.AgePyramidDataRequired
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"

AgePyramidData

The data prop: one object for the whole chart.

PropTypeDefault
max: The top of the value scale.numberRequired
aTok: The colour token of the first side.stringRequired
bTok: The colour token of the second side.stringRequired
rows: One entry per row.AgePyramidRow[]Required

AgePyramidRow

One object per entry in rows.

PropTypeDefault
label: The name shown on the chart.stringRequired
a: The value on the left (aTok).numberRequired
b: The value on the right (bTok).numberRequired

The data as a JSON Schema: schemas/age-pyramid.json

Age pyramid: a React and Figma chart in four sizes

What does an age pyramid show?

An age pyramid sets two groups back to back, with age bands as rows, so you compare their age mix in one shape. Use it for new against returning customers, users by gender or members by region.

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 Age pyramid component?

It is one <AgePyramid> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is a share per age band for two groups.

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?

  • Are there two groups? Yes means the age pyramid fits.
  • Are the rows ordered bands? Yes means the age pyramid fits.
  • Is it shares, not answers? Yes means the age pyramid fits.

When does another type fit better?

  • One group by age. Use Horizontal bars instead.
  • Items with no order. Use Dumbbell instead.
  • Survey answers on a scale. Use Likert instead.

Age pyramid 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.