Gauge
A half-dial gauge: the needle swings to the value with a little overshoot, the arc fills behind it and the number counts up in the middle, with the label under it.
data/gauge- Data
- stat
- Full frame
- 6 s (3–30 s)

npx volito render data/gauge --style cream --out gauge.movRender it
npx volito render data/gauge --prop title="Audience retention" --prop label="watched past the first minute" --out gauge.movThat writes ProRes 4444. The same item in another shape, brand or format:
volito render data/gauge --aspect 9:16 --style cobalt --out gauge-9x16.mov
volito render data/gauge --format mp4 --out gauge.mp4
volito still data/gauge --t 3 --out gauge.png
volito info data/gauge # every prop and part
volito add data/gauge # copy its source into ./motion to editFrom Node:
import { findItem, renderVideo } from "volito";
await renderVideo(findItem("data/gauge"), { props: { title: "Audience retention", label: "watched past the first minute" }, out: "gauge.mov" });Or ask an agent with the MCP server connected: “Render the Volito gauge (data/gauge) in 9:16, in our brand.”
Props
Set each with --prop name=value, or all at once with --props and a JSON object.
| Prop | Type | Default | Takes |
|---|---|---|---|
title | text | Audience retention | ≤ 50 chars |
value | number | 72 | 0 – 1000000000 |
maxMaximum | number | 100 | 1 – 1000000000 |
label | text | watched past the first minute | ≤ 60 chars |
prefixBefore numbers | text | — | ≤ 3 chars |
suffixAfter numbers | text | % | ≤ 6 chars |
decimals | number | 0 | 0 – 3 |
zonesGood zone | boolean | true | — |
Parts
Each part takes any move, ease or idle: --motion ground.in=pop.
| Part | What it is |
|---|---|
ground | the ground |
title | the heading |
dial | the dial, ticks and zone |
needle | the needle |
value | the number |
label | the label |
More in Data
Line chart
A line draws on through its points over a soft area, each point popping as the line reaches it, the last value called out, against an optional target.
Donut chart
Segments sweep round a ring one after another, the centre counts up to the total (or the first share), and a legend lists each part.
Bar chart race
Ranked bars grow and overtake each other as the periods advance; the axis rescales and the period counts up in the corner.
Goal meters
Rows of capsule meters fill to their share of a goal, each with its label and a percentage counting up.
Versus
Two sides face off: a label and a big number counting up on each, a VS badge popping between them and a split bar settling to their ratio.
Timeline
Milestones along a line that draws itself: each date's dot pops as the line reaches it and its words rise beside it.