Skip to content
WunderUI

Funnel Chart

Pro

Funnel 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

Funnel chart, 5 parts: Impressions 2.6M, Product view 1.1M, Initiate checkout 462.2k, Total products 194.1k, Marketing sales 81.5k.
Funnel Charts, data table
nameValuePrevious periodFrom previousFrom first
Impressions2.6M2.5M––
Product view1.1M1.1M42%42%
Initiate checkout462.2k502.2k42%17.6%
Total products194.1k226k42%7.4%
Marketing sales81.5k101.7k42%3.1%

Playground Funnels

Conversion funnel

Funnel chart, 5 parts: Visitors 48.2k, Sign-ups 12.9k, Activated 7.4k, Trial 3.9k, Paid 1.5k.
Conversion funnel, data table
nameValueFrom previousFrom first
Visitors48.2k––
Sign-ups12.9k26.8%26.8%
Activated7.4k57.4%15.4%
Trial3.9k52.7%8.1%
Paid1.5k38.5%3.1%

Playground Flared and stepped

Funnel Charts

Funnel chart, 6 parts: Impressions 2.6M, Product view 1.1M, Initiate checkout 462.2k, Total products 194.1k, Marketing sales 81.5k, Purchases 34.2k.
Funnel Charts, data table
nameValueFrom previousFrom first
Impressions2.6M––
Product view1.1M42%42%
Initiate checkout462.2k42%17.6%
Total products194.1k42%7.4%
Marketing sales81.5k42%3.1%
Purchases34.2k42%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:

tsx
import {
  FunnelChart,
  FunnelChartLook,
  FunnelChartProps,
  FunnelChartVariant,
} from "@wunderui/react/charts"

Then use it:

tsx
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

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

Funnel chart, 5 parts: Visitors 48.2k, Sign-ups 12.9k, Activated 7.4k, Trial 3.9k, Paid 1.5k.
Conversion funnel, data table
nameValueFrom previousFrom first
Visitors48.2k––
Sign-ups12.9k26.8%26.8%
Activated7.4k57.4%15.4%
Trial3.9k52.7%8.1%
Paid1.5k38.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

Funnel chart, 5 parts: Visitors 48.2k, Sign-ups 12.9k, Activated 7.4k, Trial 3.9k, Paid 1.5k.
Conversion funnel, data table
nameValueFrom previousFrom first
Visitors48.2k––
Sign-ups12.9k26.8%26.8%
Activated7.4k57.4%15.4%
Trial3.9k52.7%8.1%
Paid1.5k38.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

Funnel chart, 4 parts: Impressions 2.6M, Product view 1.1M, Checkout 462.2k, Purchases 194.1k.
Checkout funnel, data table
nameValueFrom previousFrom first
Impressions2.6M––
Product view1.1M42%42%
Checkout462.2k42%17.6%
Purchases194.1k42%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

Funnel chart, 5 parts: Visitors 48.2k, Sign-ups 12.9k, Activated 7.4k, Trial 3.9k, Paid 1.5k.
Sign-up funnel, data table
nameValueFrom previousFrom first
Visitors48.2k––
Sign-ups12.9k26.8%26.8%
Activated7.4k57.4%15.4%
Trial3.9k52.7%8.1%
Paid1.5k38.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.

TaborShiftTab
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

Funnel chart, 5 parts: Visitors 48.2k, Sign-ups 12.9k, Activated 7.4k, Trial 3.9k, Paid 1.5k.
Conversion funnel, data table
nameValueFrom previousFrom first
Visitors48.2k––
Sign-ups12.9k26.8%26.8%
Activated7.4k57.4%15.4%
Trial3.9k52.7%8.1%
Paid1.5k38.5%3.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.

  • data-slot="chart-plot"

    The focusable region. Arrow keys walk the marks and the live region reads each one as the tooltip shows it.

  • data-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.

  • data-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.

PropTypeDefaultDescription
data requiredreadonly ChartDatum[]—One object per slice / ring / axis.
index requiredstring—Field holding the label.
valuestring—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 .
previousstring—Area variants: field of the previous period, drawn as a pale band behind.
mirrorstring—: field of the second side (the first is ).
sideLabelsreadonly [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).
colorsreadonly ChartColor[]—Colours per row, in order (palette names or token expressions).
valueFormatterChartValueFormatter—
labelstring—Accessible name, e.g. the card title.
heightnumber—Height of the plot frame in px. Default 280 (Figma small card plot).
state"ready" | "loading" | "empty" | "error"—
activeIndexnumber | null—The active point (hovered or focused) as an index into , to control it yourself. shows none.
animateboolean—
animationKeystring | number—
defaultActiveIndexnumber | null—The point that is active at first, for an uncontrolled chart. It shows the tooltip without a pointer.
descriptionstring—
emptyDescriptionstring—Text under the title in the empty state.
emptyTitlestring—Title of the message in the empty state.
errorDescriptionstring—Text under the title in the error state.
errorTitlestring—Title of the message in the error state.
hiddenSeriesreadonly 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.
patternChartPattern | 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.
tooltipboolean—
widthnumber—

Notes for AI

Give your coding assistant the Markdown reference instead of screenshots.

MCPget_component("funnel-chart")
InstallIncluded in Core and Pro

The full library index for assistants is at /llms.txt.