Timeline

List events in order, such as a changelog or an activity feed.

General

The basic Timeline usage.

With Icons

Replace the dot with any icon using icon.

Order tracking

Use an icon for each stage, and write the time in the same format on every item.

Activity feed

Name who did what in the title and keep the detail short.

APIs

Timeline.Props

AttributeDescriptionTypeAccepted valuesDefault
...native propsHTMLAttributes--

Timeline.Item.Props

AttributeDescriptionTypeAccepted valuesDefault
titleevent titleReactNode--
timedate or time beside the titleReactNode--
iconreplaces the default dotReactNode--
...native propsHTMLAttributes--

Accessibility

  • • The timeline is an ol of li items, so a screen reader announces a list with its number of items, and the order of the items is the reading order.
  • • The title and the time are plain text. Write the time in a form people read, such as Nov 3, 2026.
Edit this page on GitHub