Skip to content

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.

Size

Item placement

itemPlacement="right" puts the markers on the right and aligns the text to them.

Horizontal

horizontal lays the items out in a row. lineType="dashed" draws a dashed line to the next item.

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.

Timeline Props

NameTypeDefaultDescriptionVersion
horizontalbooleanfalseLays the items out in a row.Unreleased
iconSizenumberundefinedMarker size in px. Defaults to the theme’s size for size.Unreleased
itemPlacementleft | rightleftWhich side the markers sit on. Ignored when horizontal.Unreleased
sizemedium | largemediumMarker and text size.Unreleased

TimelineItem Props

NameTypeDefaultDescriptionVersion
typedefault | info | success | warning | errordefaultMarker color role.Unreleased
titleReactNodeundefinedTitle above the content.Unreleased
contentReactNodeundefinedThe item’s body; children override it.Unreleased
timeReactNodeundefinedShown under the content.Unreleased
iconReactNodeundefinedReplaces the circle marker.Unreleased
colorstringundefinedA custom marker color.Unreleased
lineTypedefault | dasheddefaultThe line to the next item.Unreleased

title and time take any ReactNode.