TrademarkTrademarkDocs
Ctrl k
Search docs...
Components

Timeline

Updated: September 21, 2026
View on GitHub
Timeline helps visualize sequences of events, process steps, or historical data. Configure items via an object array with simple props or custom React nodes. It lays a sequence out down the page, one item after another. If you are building a video or audio editor, the component you want is Scrubber: a playhead over time, with stacked tracks of blocks that are selectable, movable and trimmable. The two share a name in spirit and nothing in purpose. Use label and description props for quick setup. Control timeline alignment with the alignment prop. Use left or right for different layouts. Control size with the size prop: xs, s, m, l or xl. Customize the marker with the marker prop. Visual feedback with different marker states: default, active, success, and danger. Extend the label and description with custom React nodes. Use the children prop with additional content to extend the layout. Use the marker prop to render custom marker elements.
Prop
Type
Default
itemsrequired
The events, in order.
TimelineItem[]—
alignment
Which side of the line the content sits on.
leftright
left
size
Scale of the markers and text.
xllmsxs
m
…and every FlexProps propinherited—
direction
columnrow
column
Prop
Type
Default
label
ReactNode—
description
ReactNode—
state
defaultactivecompletederror
default
marker
ReactNode—
children
React.ReactNode—
Edit this page on GitHub
TrademarkTrademark
Built with curiosity by Lorant One and the Design Engineers Club