funnel
Use for ordered stages with a non-negative count (y ≥ 0). Keep input stage order. series is ignored. Negatives fail with E_NEGATIVE_VALUE.
Do not use for part-to-whole slices (pie) or signed running totals (waterfall).
x stage · y number ≥ 0 · series ignored
Rules. Keep order. Centered bands narrow from each stage's value to the next. The stage name and value sit to the right of the shape. Negatives → E_NEGATIVE_VALUE.
Example
chart
markvis: 2
type: funnel
title: Activate still keeps 180 of 1,200 Midtown visits
x: stage
y: people
stage,people
Visit,1200
Signup,480
Verify,310
Activate,180| stage | people |
|---|---|
| Visit | 1200 |
| Signup | 480 |
| Verify | 310 |
| Activate | 180 |
When the block is wrong
The rows stay, with one line that names the error.
chart
markvis: 2
type: funnel
title: Negative stage
x: stage
y: people
stage,people
Visit,1200
Signup,-40| stage | people |
|---|---|
| Visit | 1200 |
| Signup | -40 |
E_NEGATIVE_VALUE: funnel values must be >= 0
Generated from packages/types/funnel/ and the type's row in SPEC.md.