Components/Lists/Timeline
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/timeline
Timeline displays a vertical list of past events in a chronological order.
<HorizontalTimeline/> instead.<Stepper/> component instead.Add content to a timeline by using `items` prop. Each item has props to control these containers:
 - `customPrefix` - overrides the default circle with a specified icon to mark important milestones.
 - `label` - describes the event.
 - `labelAction` - enables an action that provides more info or leads to an event.
 - `suffix` - displays event's date or other additional info.
Note that all of these containers are nodes (i.e., can store any component as a child item). Their positions are fixed.
Control vertical distance between the items with a `gap` prop.
Default value is 30 px.
Set the content for an item's label with a `label` prop.
Label describes the event of the Timeline item. It wraps into multiple lines where necessary.
Note that the label container accepts any component as a child item.
Add an action button for a Timeline's item using a `labelAction` prop.
Use it as a link to actions or further information about the Timeline item.
Set a custom icon for a Timeline item with a `customPrefix` prop. Use it to highlight important milestones or errors.
Control it for each item individually.
When not defined, prefix is a default filled-in circle.
Add more information to the Timeline item with a `suffix` prop.
Use it to show the date of an event (but it can also render any component as a child item).
Illustrate the history of a product order with a Timeline, stored inside a <Card/>.
In this case, users can fill in recent events into the Timeline themselves, change events' status, and view more related information.
| Name | Type | Default | Description |
|---|---|---|---|
dataHook | string | — | Applies a data-hook HTML attribute to be used in the tests. |
gap | string | — | Sets the distance that separates each item from the one below. |
items (required) | TimelineItem[] | — | Defines each individual event item in the component: - label stores a text string naming the event or renders other components as its children - labelAction stores an action button (or other components) related to the event - customPrefix defines a custom milestone symbol for an item on the vertical axis - suffix stores a date of the event (or other components) |
skin | "standard" | "neutral" | "dark" | — | Sets the skin of the component. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getLabelText | Gets the label text of timeline item by index |
getSuffixText | Get the suffix text of timeline item by index |
getSkin | Gets skin type |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
Last updated: 30 October 2026