Timeline
Use Timeline for events in the order they happened or will happen: an activity log, a change history, a deployment’s events, a roadmap. For the stages of a process people are going through, use Steps.
Put each TimelineItem directly inside Timeline: the item is an li, and Timeline is the ol around it.
Timeline lists events in order. Each TimelineItem has a marker, an optional title, its content and a time, and a line runs from each marker to the next.
#Demos
#Basic
type colors the marker: default, info, success, warning or error. The last item has no line after it.
- DraftDraft opened for review2026-10-01 09:12
- ChecksAll checks passed2026-10-01 10:40
- ReviewOne reviewer asked for changes2026-10-01 14:05
- DeployDeploy to staging failed2026-10-01 16:30
- ReleaseWaiting on the release window2026-10-02 08:00
#Size
- MediumMedium is the default09:00
- DoneThe last item has no line10:00
- LargeA larger marker and title09:00
- DoneThe last item has no line10:00
#Item placement
itemPlacement="right" puts the markers on the right and aligns the text to them.
- LeftMarkers on the left09:00
- LeftThe default placement10:00
- RightMarkers on the right09:00
- RightText aligns to the markers10:00
#Horizontal
horizontal lays the items out in a row. lineType="dashed" draws a dashed line to the next item.
- Order placedMon
- PackedTue
- ShippedWed
- Out for deliveryThu
#Icon and color
icon replaces the circle and takes the type’s color; iconSize sets the marker size for the whole timeline. color gives one item a custom color: take it from the theme aliases so it follows the theme.
- ShippedAn icon replaces the circle
- In transitIt takes the type's color
- Custom colorOr a custom color
#Timeline Props
| Name | Type | Default | Description | Version |
|---|---|---|---|---|
horizontal | boolean | false | Lays the items out in a row. | Unreleased |
iconSize | number | undefined | Marker size in px. Defaults to the theme’s size for size. | Unreleased |
itemPlacement | left | right | left | Which side the markers sit on. Ignored when horizontal. | Unreleased |
size | medium | large | medium | Marker and text size. | Unreleased |
#TimelineItem Props
| Name | Type | Default | Description | Version |
|---|---|---|---|---|
type | default | info | success | warning | error | default | Marker color role. | Unreleased |
title | ReactNode | undefined | Title above the content. | Unreleased |
content | ReactNode | undefined | The item’s body; children override it. | Unreleased |
time | ReactNode | undefined | Shown under the content. | Unreleased |
icon | ReactNode | undefined | Replaces the circle marker. | Unreleased |
color | string | undefined | A custom marker color. | Unreleased |
lineType | default | dashed | default | The line to the next item. | Unreleased |
title and time take any ReactNode.