Span waterfall
One run's steps, and where the time went.
Definition · Updated Nov 2, 2026
A span waterfall draws each step of one run as a bar starting where it began, so the slow step stands out. A second marker can show the run time after a fix. Use it for agent runs, traces and request timings.
Pay once. Every update included.
Live preview
Sample data: one 9.1 s run, plan 0.8 s, six fetches 6.1 s, write 1.7 s, 4.4 s after the fix
- Data shape
- Steps with a start and a length
- Good for
- Agent runs, traces, request timings
- Avoid when
- Steps are nested deeply
- Sizes
- XS, S, M and L, re-laid out from the data
Anatomy
Inspect it like the Figma file.
The same layers, names and tokens as the component. Select one to read its size, fill and style.
Layers
107 / Span waterfall
- Layer
- span · run
- Type
- Rectangle
- Size
- 605 × 10
- Fill
- data/cat-2
- Radius
- 2
- Group
- Marks · 20
Layers
107 / Span waterfall
- Layer
- span · run
- Type
- Rectangle
- Size
- 303 × 10
- Fill
- data/cat-2
- Radius
- 2
- Group
- Marks · 20
Layers
107 / Span waterfall
- Layer
- span · run
- Type
- Rectangle
- Size
- 157 × 10
- Fill
- data/cat-2
- Radius
- 2
- Group
- Marks · 20
Sizes
Re-laid out, never scaled.
The same data at XS, S, M and L. Every size is redrawn from the data, so text and line weights never shrink.
M against S
Width360 px480 px
Plot328 px440 px
Labels1818
Marks2020
Height212 px246 px
Same tokens at every size: text styles, 1 px lines and mark radius stay put.
When to use
Which step is slow.
Three signs it fits, and three signs another type fits better.
Are the steps in one flat list?
Steps nested in steps.
Yes: Keep the span waterfall
Code and Figma
One name in Figma and in code.
Every Figma property is a prop with the same name and values. One command installs it.
Figma
chart/107-span-waterfall
npx shadcn add @chartory/span-waterfallimport { SpanWaterfall } from "@/components/chartory/span-waterfall"import { runSpans } from "./run-spans"export function RunSpans() { return ( <SpanWaterfall data={runSpans} size="m" legend={true} /> )}Hearth widget
Span waterfall as a widget.
The chart in a Hearth card with a hero number and two blocks. One token set, light and dark.
EmberPreset
ChartoryDefault preset
Pick the blocks, the size and the preset for your own widget.
Read the Hearth widget docsFAQ
Span waterfall questions.
What people ask before they put a span waterfall in a dashboard.
Something else?
hello@usechartory.comThe run time if the slow span is fixed (4.4 s against 9.1 s now), drawn as its own marker.
The step ran six times; the bar covers all six (6 × 6.1 s).
One data object in the sample’s shape: steps with a start and a length. The docs page lists every field and links its JSON Schema; the sample data comes with the component, so you can start from it and swap in your own.
Series take the preset’s data colours in order, and states such as up, down or warning take its status colours. Change the preset in Figma or in code to recolour every chart at once.
XS, S, M and L, in light and dark. Each size is laid out again from the data, so text and lines keep their size.
Yes. It plays in when it scrolls into view, and when the data changes every mark moves from its old place to its new one. With reduced motion on, it does not move.
Yes. The Figma component comes with Figma and Complete, the React component with Code and Complete.
Ask for it by name. The MCP server tells the agent what data it needs and runs the same command: npx shadcn add @chartory/span-waterfall. You review the diff.
Related types
Other ways to show schedule and status.
The same question, a different shape of answer. Every type ships in Figma and in code.
Same family
Schedule and status
19 types in Chartory answer this question.