HorizontalTimeline

Components/Lists/HorizontalTimeline

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/horizontaltimeline

Overview

Copy

HorizontalTimeline is used to demonstrate the progress of passive events that a person watching it has no effect on.

Do

  • Use it to demonstrate the progress of server states.
  • Use it to show task SLA status.

Don't

  • Don't use it as part of onboarding flow, use <Stepper/> component instead.
  • Don't use it to show a long history of events, use <Timeline/> component instead.

Feature examples

Structure

Create timeline content by using `items` prop. Each item has props to control `label`, `width`, `icon` and `state`.

Copy

Align Label

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.

Copy

Skin

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.

Copy

Line Type

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.

Copy

Item Icons

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.

Copy

Common use case examples

Connect Domain

One of the applications where this component is helpful — it shows the status of domain connection that was requested by a user.

Copy

Code

Copy

Props

NameTypeDefaultDescription
alignLabel"center" | "start"'center'Aligns the labels of items.
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
itemsHorizontalTimelineItem[]—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.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
getLabelGets the label text of timeline item by index
getSkinGets skin type
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
  • 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
  • 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
  • 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.311.0 (2026-08-12) — fix: the HorizontalTimelineItem type is now exported, so items passed to the items prop can be typed. (#16795)
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.291.0 (2026-06-19) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.258.0 (2026-02-23) — breaking: tokenization (#15951)
  • 1.250.0 (2026-01-27) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 22 October 2026

Did this help?