2.0 alpha
These docs describe 2.0. Install it with @once-ui-system/core@alpha.
On 1.8.x? Read the 1.x docs
TrademarkTrademarkDocs
Ctrl k
Search docs...
Components

Timeline

Updated: October 14, 2025
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. 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