ant-design/components/timeline/index.en-US.md

---
category: Components
type: Data Display
title: Timeline
---

Vertical display timeline.

## When To Use

- When a series of information needs to be ordered from top to bottom by time.
- When you need a timeline to make a visual connection.

## API

```jsx
<Timeline>
  <Timeline.Item>step1 2015-09-01</Timeline.Item>
  <Timeline.Item>step2 2015-09-01</Timeline.Item>
  <Timeline.Item>step3 2015-09-01</Timeline.Item>
  <Timeline.Item>step4 2015-09-01</Timeline.Item>
</Timeline>
```

### Timeline

Timeline

| Property      | Description                                     | Type       | Default |
|----------|----------------------------------------|------------|-------|
| pending  | Set the last ghost node's existence or its content | boolean\|string\|ReactNode | `false`  |

### Timeline.Item

Node of timeline

| Property      | Description                                     | Type       | Default |
|----------|------------------------------------------|------------|-------|
| color   | Set the circle's color to `blue`, `red`, `green` or other custom colors | string | `blue` |
| dot   | Customize timeline dot | string\|ReactNode | -  |