# 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 (`
    ` / `
  1. `), so screen readers announce the order and count - `Time` renders in a `