# Timeline
> A vertical list of events in order.
Source: https://shellui.dev/docs/v0.4/components/data-display/timeline
`Timeline` is **new in v0.4**. It renders `TimelineItem`s down a connecting line, each with a title, a time and optional details.
## Installation
```bash
shellui add timeline
```
This also installs `TimelineItem`.
## Usage
### Basic
Mark the current event with `Active`.
```razor
Left at the front desk.The courier picked up the parcel.
```
### With icons
An `Icon` replaces the dot. When you use the `Icon` slot, put the details in ``.
```razor
Build 412 is live.Reviewed and approved by two people.
```
## API Reference
### Timeline
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `ChildContent` | `RenderFragment?` | `null` | The `TimelineItem`s |
| `Class` | `string?` | `null` | Additional CSS classes |
### TimelineItem
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `Title` | `string?` | `null` | Event title |
| `Time` | `string?` | `null` | When it happened, already formatted |
| `Active` | `bool` | `false` | Highlights the marker |
| `Icon` | `RenderFragment?` | `null` | Replaces the dot |
| `ChildContent` | `RenderFragment?` | `null` | Details under the title |
| `Class` | `string?` | `null` | Additional CSS classes |
## Accessibility
- Renders an ordered list (`` / `
`), so screen readers announce the order and count
- `Time` renders in a `