Skip to content
DocsChartsIsotypeLast updated Nov 2, 2026

Isotype

Counts drawn as rows of icons. Sample data: orders by channel, one box = 100, web 1,840, retail 310.

Open in
Orders by channel4,170 orders this week by channel, one box per 100: Web 1,840, App 1,260, Marketplace 760, Retail 310.Web1,840App1,260Marketplace760Retail310WEBAPPMARKETPLACERETAIL · 1 BOX = 100
Orders by channel
ChannelOrders
Web1840
App1260
Marketplace760
Retail310
Orders by channel4,170 orders this week by channel, one box per 100: Web 1,840, App 1,260, Marketplace 760, Retail 310.Web1,840App1,260Marketplace760Retail310WEBAPPMARKETPLACERETAIL · 1 BOX = 100
Orders by channel
ChannelOrders
Web1840
App1260
Marketplace760
Retail310

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

    npx shadcn add @chartory/isotype
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { Isotype }  from "@/components/chartory/isotype"<Isotype  data={channelOrders}  size="m"  legend/>

Props

<Isotype>

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

IsotypeData

The data prop: one object for the whole chart.

PropTypeDefault
unit: What one icon stands for.numberRequired
rows: One entry per row.IsotypeRow[]Required

IsotypeRow

One object per entry in rows.

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

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

Isotype chart: a React and Figma chart in four sizes

What does an isotype chart show?

An isotype chart draws counts as rows of icons, each standing for a set amount, so a number becomes something you can see. Use it for orders, people or parcels when the audience reads pictures faster than bars.

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 Isotype component?

It is one <Isotype> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is a count per item and a unit per icon.

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 they countable things? Yes means the isotype fits.
  • Is a rough count enough? Yes means the isotype fits.
  • Is it a split of a total? Yes means the isotype fits.

When does another type fit better?

  • Amounts like money. Use Horizontal bars instead.
  • Exact values matter. Use Horizontal bars instead.
  • Shares around a ring. Use Semi donut instead.

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