Components/Lists/HorizontalTimeline
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/horizontaltimeline
HorizontalTimeline is used to demonstrate the progress of passive events that a person watching it has no effect on.
<Stepper/> component instead.<Timeline/> component instead.Create timeline content by using `items` prop. Each item has props to control `label`, `width`, `icon` and `state`.
Control text horizontal alignment with alignLabel prop. It has two options:
 - center (default) - use it in all common cases.
 - start - use it to align text to the left.
Control the style with skin prop. It supports 2 options:
 - dark (default) - use it on colored backgrounds, for example inside SectionHelper.
 - standard - use it on light backgrounds, for example inside a card.
Control the line type with line prop. It supports 2 options:
 - dashed (default) - use it on colored backgrounds, for example inside SectionHelper.
 - filled - use it to show that this timeline is past.
Specify item status by using icon prop for items:
 - DefaultIcon - indicates incomplete steps.
 - ActiveIcon - highlights currently active step.
 - CompleteIcon - indicates complete steps.
 - DestructiveIcon - indicates a step that failed to complete.
 - BoundaryIcon - indicates a milestone that doesn't have status, but should be reflected in the timeline.
One of the applications where this component is helpful — it shows the status of domain connection that was requested by a user.
| Name | Type | Default | Description |
|---|---|---|---|
alignLabel | "center" | "start" | 'center' | Aligns the labels of items. |
dataHook | string | — | Applied as data-hook HTML attribute that can be used in the tests. |
items | HorizontalTimelineItem[] | — | Timeline items * skin - Controls line and text color (deprecated). * line - Affects the line type, can be one of: 'filled' | 'dashed'. * label - Text displayed below the icon. * icon - An icon representing a timeline item. * width - The width of the timeline item, can be percentage or pixels. * labelEllipsis - Set ellipsis for item's label . |
skin | "standard" | "dark" | 'dark' | Controls the line and text color of the item. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getLabel | Gets the label 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. |
HorizontalTimelineItem type is now exported, so items passed to the items prop can be typed. (#16795)Last updated: 22 October 2026