Funnel Chart
ProFunnel chart for conversion between steps: trapezoid funnel and pyramid, bar funnels and KPI-column funnel areas in twelve looks, with the step conversion in the tooltip. Stages take the indigo tones; hovering a stage dims the others.
Playground Funnel Charts
Funnel Charts
| name | Value | Previous period | From previous | From first |
|---|---|---|---|---|
| Impressions | 2.6M | 2.5M | – | – |
| Product view | 1.1M | 1.1M | 42% | 42% |
| Initiate checkout | 462.2k | 502.2k | 42% | 17.6% |
| Total products | 194.1k | 226k | 42% | 7.4% |
| Marketing sales | 81.5k | 101.7k | 42% | 3.1% |
Playground Funnels
Conversion funnel
| name | Value | From previous | From first |
|---|---|---|---|
| Visitors | 48.2k | – | – |
| Sign-ups | 12.9k | 26.8% | 26.8% |
| Activated | 7.4k | 57.4% | 15.4% |
| Trial | 3.9k | 52.7% | 8.1% |
| Paid | 1.5k | 38.5% | 3.1% |
Playground Flared and stepped
Funnel Charts
| name | Value | From previous | From first |
|---|---|---|---|
| Impressions | 2.6M | – | – |
| Product view | 1.1M | 42% | 42% |
| Initiate checkout | 462.2k | 42% | 17.6% |
| Total products | 194.1k | 42% | 7.4% |
| Marketing sales | 81.5k | 42% | 3.1% |
| Purchases | 34.2k | 42% | 1.3% |
Installation
Funnel Chart comes with WunderUI Core and Pro, in the package from your plan. See the plans.
The charts live in their own entry point: import the chart, its card and its hooks from @wunderui/react/charts, not from @wunderui/react.
Then import what you need:
import {
FunnelChart,
FunnelChartLook,
FunnelChartProps,
FunnelChartVariant,
} from "@wunderui/react/charts"Then use it:
import { FunnelChart } from "@wunderui/react/charts"
const data = [
{ name: "Visitors", value: 48200 },
{ name: "Sign-ups", value: 12900 },
{ name: "Activated", value: 7400 },
{ name: "Paid", value: 1500 },
]
export function ConversionFunnel() {
return <FunnelChart data={data} index="name" label="Conversion funnel" />
}Expected result: You see four stages narrowing from Visitors to Paid. Hovering a stage shows its value and the conversion from the previous one.
When to use
Use Funnel Chart for
- How a count drops through ordered stages: visitors to paid accounts
- A checkout or an onboarding with the drop-off from each stage
- A pyramid for a layered model
- Two sides compared (mirrored funnel), or this period against the last
Use something else for
- Waterfall Chart for changes that add up and subtract
- Sankey Chart for flows that split between stages
- Bar Chart for stages that are not ordered
- Progress Chart for completion against a target
States
Loading, empty and error keep the chart's size, so the card never jumps. Add a retry handler and the error state offers a Try again button.
Conversion funnel
| name | Value | From previous | From first |
|---|---|---|---|
| Visitors | 48.2k | – | – |
| Sign-ups | 12.9k | 26.8% | 26.8% |
| Activated | 7.4k | 57.4% | 15.4% |
| Trial | 3.9k | 52.7% | 8.1% |
| Paid | 1.5k | 38.5% | 3.1% |
Stage colours
The stages of a funnel are one flow, so they take one hue: the indigo tones, 600 for the first stage down to 200, with the stage name in white or near-black, whichever reads on its tone. Hover a stage and the others step back to the dimmed level, as in every chart. For stages that are not one flow, palette="series" takes the palette order; colors still sets each stage.
Conversion funnel
| name | Value | From previous | From first |
|---|---|---|---|
| Visitors | 48.2k | – | – |
| Sign-ups | 12.9k | 26.8% | 26.8% |
| Activated | 7.4k | 57.4% | 15.4% |
| Trial | 3.9k | 52.7% | 8.1% |
| Paid | 1.5k | 38.5% | 3.1% |
Variant names
The funnel draws twelve looks. The other names of the Figma catalogue are aliases: they keep working and draw one of the twelve, because the number of stages, rising data or a smaller card never needed a look of its own. funnel-area-with-plateau → funnel-area; funnel-area-7-steps · funnel-area-6-steps · compact-funnel-area · rising-funnel-area → curved-funnel-area; compact-flared-funnel-area → flared-funnel-area; compact-rounded-step-funnel-area → rounded-step-funnel-area; rising-step-funnel-area → step-funnel-area.
Checkout funnel
| name | Value | From previous | From first |
|---|---|---|---|
| Impressions | 2.6M | – | – |
| Product view | 1.1M | 42% | 42% |
| Checkout | 462.2k | 42% | 17.6% |
| Purchases | 194.1k | 42% | 7.4% |
Patterns
pattern fills the stages with one form from the shared pattern library — stripes, dots or cross-hatch — drawn in each colour on a tint of it, for print and for readers who cannot tell the colours apart. One form per chart; a mark under 20 px on its shorter side stays solid.
Sign-up funnel
| name | Value | From previous | From first |
|---|---|---|---|
| Visitors | 48.2k | – | – |
| Sign-ups | 12.9k | 26.8% | 26.8% |
| Activated | 7.4k | 57.4% | 15.4% |
| Trial | 3.9k | 52.7% | 8.1% |
| Paid | 1.5k | 38.5% | 3.1% |
Keyboard interactions
The plot is focusable: arrow keys step through the stages, and the live region reads each with its value and its conversion from the first and previous stage.
- TaborShift+Tab
- Moves focus to the plot and away from it. The plot is one tab stop; so is every legend badge.
- ArrowRightorArrowLeft
- Moves to the next or previous stage. The tooltip follows, and a live region announces the one you are on. The first press starts at the first one (Left: the last one).
- HomeorEnd
- Jumps to the first or last stage.
- Escape
- Clears the active point.
- EnterorSpace
- On a legend badge of a ChartCard: switches its series off or on. The last visible series stays on.
Behavior and motion
What the chart does on its own and what the page decides.
- Stages
- Each row of the data is a stage, widest first. You say which field holds the stage name and which holds the count.
- Options by variant
- Mirror adds a second side (indigo against pink) and side labels name the two. Previous draws a pale band of the earlier period behind the area funnels, color sets the area colour, palette="series" swaps the indigo tones for the palette order and colors sets one colour per stage. Twelve looks: the other Figma names (funnel-area-with-plateau, funnel-area-7-steps, funnel-area-6-steps, compact-funnel-area, rising-funnel-area, compact-flared-funnel-area, compact-rounded-step-funnel-area, rising-step-funnel-area) are aliases that draw one of them (FUNNEL_VARIANT_ALIASES).
- Conversion
- The stepped variants show the share carried over from the stage before as a badge. The tooltip gives From previous and From first percentages for every stage after the first.
- Hover
- The stage under the pointer or focus turns two steps lighter in its own colour scale, with a near-black label that stays readable in light and dark.
- Loading, empty and error
- The chart keeps its size while loading, empty or failed, so the card never changes height. Add a retry handler to show a Try again button on error.
- Legend
- A ChartCard shows series as badges. With two or more series each badge toggles its series, the last visible one stays on, and a legend of roles can be made static.
- Data table
- The chart also renders its data as a table for screen readers, in plot order.
- Size
- The chart fills the width of its container, and you set the plot height. Text never scales: labels keep their size at every width.
Motion
The enter sequence and hover follow the library's motion tokens.
- Enter
- Marks play an enter sequence the first time the chart is in view, and again after loading or when new data arrives. You can turn it off.
- Reduced motion
- With reduced motion the enter sequence is off and the chart appears at once. Tooltip, crosshair and every state still work.
Anatomy
FunnelChart shows how a count drops through ordered stages, as trapezoids, a pyramid, bars, a stepped list with conversion badges, or area funnels behind KPI columns.
Conversion funnel
| name | Value | From previous | From first |
|---|---|---|---|
| Visitors | 48.2k | – | – |
| Sign-ups | 12.9k | 26.8% | 26.8% |
| Activated | 7.4k | 57.4% | 15.4% |
| Trial | 3.9k | 52.7% | 8.1% |
| Paid | 1.5k | 38.5% | 3.1% |
- 1
Takes one row per stage, with the stage name and its value. Options add a mirrored second side, a pale band for the previous period, an area colour and side labels.
- 2data-slot="chart-plot"
The focusable region. Arrow keys walk the marks and the live region reads each one as the tooltip shows it.
- 3data-slot="chart-marks"
The stage shapes, drawn from the widest in the indigo tones (600 for the first stage down to 200). Trapezoids open from the funnel's axis, top to bottom; the area looks draw a smooth, curved, stepped or flared surface across the KPI columns, strongest at its value edge.
- Optional
The stage under the pointer or focus keeps its strength and every other stage dims to --chart-dim, the hover of every chart. On the area looks the area dims (--chart-dim-area) and the hovered stage's part of the same area stays, cut at the column edges.
- Optional
On the stepped variants, the share carried over from the stage before, so the drop is stated and not left to the eye.
- 4data-slot="chart-tooltip"Optional
The stage value (and the second side on the mirrored funnel), then From previous and From first percentages for every stage after the first.
- data-slot="chart-message"Optional
Five muted bars of falling width stand in for the stages while loading. A retry handler adds a Try again button to the error message.
A table of the stages and values for screen readers.
- data-slot="funnel-area"
- data-slot="funnel-previous"Optional
- data-slot="chart-hover-stage"
Best practices
- Do
Order the data from first stage to last and keep it to four to seven stages. If a stage can grow above the previous one, a funnel is the wrong model.
- Do
Print the numbers. Trapezoid width is easy to misjudge, so show the count and the conversion in the label or badge.
- Do
Use the mirrored funnel only for two groups with the same stages, such as two plans, and name them with side labels.
- Don’t
Don't use the area variants without KPI numbers beside them. They are a backdrop for a metric row, not a chart to read alone.
- Don’t
Don't mix absolute counts and percentages across stages. Every stage uses the same unit.
API reference
One table for FunnelChart, listing every prop. The ChartCard around it takes its own props (title, legend, periods, table and more), and the chart works without one.
Takes one row per stage, with the stage name and its value. Options add a mirrored second side, a pale band for the previous period, an area colour and side labels.
| Prop | Type | Default | Description |
|---|---|---|---|
| data required | readonly ChartDatum[] | — | One object per slice / ring / axis. |
| index required | string | — | Field holding the label. |
| value | string | — | Field holding the value. Default "value". |
| variant | "vertical-funnel" | "horizontal-funnel" | "pyramid" | "mirrored-funnel" | "stepped-funnel" | "funnel-area" | "funnel-area-7-steps" | "funnel-area-6-steps" | "flared-funnel-area" | "rounded-step-funnel-area" | "step-funnel-area" | "funnel-area-edge-fade" | "flared-step-funnel-area" | "compact-funnel-area" | "funnel-area-with-plateau" | "rising-funnel-area" | "compact-flared-funnel-area" | "compact-rounded-step-funnel-area" | "rising-step-funnel-area" | "curved-funnel-area" | "vertical-funnel" | Variant (a look or one of its aliases). Default . |
| previous | string | — | Area variants: field of the previous period, drawn as a pale band behind. |
| mirror | string | — | : field of the second side (the first is ). |
| sideLabels | readonly [string, string] | ["A", "B"] | Labels of the two sides of the mirrored funnel. |
| color | "indigo" | "blue" | "purple" | "green" | "orange" | "pink" | "yellow" | "red" | "grey" | "indigo" | Area variants and the stepped funnel: colour of the area / the bars (default indigo). |
| colors | readonly ChartColor[] | — | Colours per row, in order (palette names or token expressions). |
| valueFormatter | ChartValueFormatter | — | |
| label | string | — | Accessible name, e.g. the card title. |
| height | number | — | Height of the plot frame in px. Default 280 (Figma small card plot). |
| state | "ready" | "loading" | "empty" | "error" | — | |
| activeIndex | number | null | — | The active point (hovered or focused) as an index into , to control it yourself. shows none. |
| animate | boolean | — | |
| animationKey | string | number | — | |
| defaultActiveIndex | number | null | — | The point that is active at first, for an uncontrolled chart. It shows the tooltip without a pointer. |
| description | string | — | |
| emptyDescription | string | — | Text under the title in the empty state. |
| emptyTitle | string | — | Title of the message in the empty state. |
| errorDescription | string | — | Text under the title in the error state. |
| errorTitle | string | — | Title of the message in the error state. |
| hiddenSeries | readonly string[] | — | Labels of rows switched off in the legend: drawn faded. |
| onActiveIndexChange | (index) => void | — | Called with the index when the pointer or the arrow keys move to another point, and with when they leave. Use it to show the hovered value in a headline. |
| onRetry | () => void | — | Shows a Try again button in the error state and calls this when it is pressed. |
| palette | "indigo" | "series" | "indigo" | Stage colours when is not set: (default) gives the stages the indigo tonal scale, 600 for the first stage down to 200 — one hue, because the stages are parts of one flow; takes the palette order. |
| pattern | ChartPattern | ChartPattern[] | — | One pattern form from the shared pattern library (, , …) for every stage (or the funnel area), drawn in its colour on a tint of it, for print and colour-blind reading. A list keeps its first entry; a mark under 20 px on its shorter side stays solid. |
| tooltip | boolean | — | |
| width | number | — |
Notes for AI
Give your coding assistant the Markdown reference instead of screenshots.
get_component("funnel-chart")The full library index for assistants is at /llms.txt.
Related components
Waterfall chart, 6 points from Q2 revenue to Q3 revenue. Change from $248k to $0k, lowest $-27k, highest $248k. Revenue bridge Q2 to Q3, data table step Change Q2 revenue $248k New business $64k Expansion $31k Contraction $-18k Churn $-27k Q3 revenue $0k Charts4 stylesProWaterfall ChartWaterfall chart for how a total changes: the start total, the changes that move it and the end total, in one indigo scale with a +/− sign on every change.Traffic from channels to signups: 15 flows between 9 nodes. Largest: Docs → Left 3.5k, Search → Docs 3.2k, Blog → Left 2.8k. Traffic from channels to signups, data table Source → target Flow Share of source Search → Docs 3.2k 54% Search → Blog 1.8k 31% Search → Pricing 0.9k 15% Direct → Pricing 1.6k 64% Direct → Docs 0.9k 36% Social → Blog 1.4k 82% Social → Pricing 0.3k 18% Referral → Docs 0.7k 58% Referral → Pricing 0.5k 42% Pricing → Signup 1.9k 58% Pricing → Left 1.4k 42% Docs → Signup 1.3k 27% Docs → Left 3.5k 73% Blog → Signup 0.4k 13% Blog → Left 2.8k 88% Traffic from channels to signups, node totals Node In Out Search – 5.9k Direct – 2.5k Social – 1.7k Referral – 1.2k Pricing 3.3k 3.3k Docs 4.8k 4.8k Blog 3.2k 3.2k Signup 3.6k – Left 7.7k – Charts6 stylesProSankey ChartSankey chart for flows between stages: basic and gradient flows, a vertical sankey, an alluvial and a chord diagram.Bar chart, 12 points from Jan to Dec. Revenue from $32.0k to $58.0k, lowest $32.0k, highest $58.0k; Expenses from $18.0k to $35.0k, lowest $18.0k, highest $38.0k. Revenue and expenses, data table month Revenue Expenses Jan $32.0k $18.0k Feb $41.0k $22.0k Mar $38.0k $27.0k Apr $47.0k $24.0k May $44.0k $30.0k Jun $52.0k $28.0k Jul $49.0k $34.0k Aug $55.0k $31.0k Sep $51.0k $36.0k Oct $46.0k $33.0k Nov $53.0k $38.0k Dec $58.0k $35.0k Charts32 stylesProBar ChartBar chart for comparing values: grouped, horizontal, diverging, top-k and highlighted bars, with tooltip, keyboard navigation and a data table.