Skip to content
DocsChartsPolar areaLast updated Nov 2, 2026

Polar area

Parts as wedges, sized by their value. Sample data: new trial signups by channel, organic 4.2K (30%), events 0.6K (4%).

Open in
Signups by channel13.8K new trial signups in September across six channels: Organic leads with 4.2K (30%), Events is smallest with 0.6K (4%).Organic4.2K30%Paid search3.4K25%Referral2.6K19%Social1.8K13%Partners1.2K9%Events0.6K4%
Signups by channel
ChannelSignupsShare
Organic420030%
Paid search340025%
Referral260019%
Social180013%
Partners12009%
Events6004%
Signups by channel13.8K new trial signups in September across six channels: Organic leads with 4.2K (30%), Events is smallest with 0.6K (4%).Organic4.2KPaid search3.4KReferral2.6KSocial1.8KPartners1.2KEvents0.6K
Signups by channel
ChannelSignupsShare
Organic420030%
Paid search340025%
Referral260019%
Social180013%
Partners12009%
Events6004%

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

    npx shadcn add @chartory/polar-area
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { PolarArea }  from "@/components/chartory/polar-area"<PolarArea  data={signupsByChannel}  size="m"/>

Props

<PolarArea>

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.PolarAreaDataRequired
size: The size class. Each one is laid out again from the data."xs" | "s" | "m" | "l""m"

PolarAreaData

The data prop: one object for the whole chart.

PropTypeDefault
items: One entry per item.PolarAreaItem[]Required

PolarAreaItem

One object per entry in items.

PropTypeDefault
label: The name shown on the chart.stringRequired
v: The value.numberRequired
tok: The colour token, e.g. "data/primary".stringRequired
text: The label as shown.stringRequired
pct?: The share as shown, e.g. "42%".string—

The data as a JSON Schema: schemas/polar-area.json

Polar area chart: a React and Figma chart in four sizes

What does a polar area chart show?

A polar area chart gives each part an equal wedge and stretches it out by its value, so big and small parts show as long and short petals. Use it for channels or categories when the shape of the mix matters more than exact shares.

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 Polar area component?

It is one <PolarArea> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is four to eight parts with a value.

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 the shape more important than exact shares? Yes means the polar area fits.
  • Are there four to eight parts? Yes means the polar area fits.
  • Is it one moment? Yes means the polar area fits.

When does another type fit better?

  • Exact shares matter. Use Donut instead.
  • Many parts. Use Treemap instead.
  • The mix over a year. Use Streamgraph instead.

Polar area 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.