> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: HorizontalTimeline Component

## Article: HorizontalTimeline Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/lists/horizontal-timeline-component.md

## Article Content:

# HorizontalTimeline

_Components/Lists/HorizontalTimeline_

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

## Overview

```jsx
<div style={{ width: '600px' }}>
  <HorizontalTimeline
    items={[
      {
        label: 'Instructions completed',
        skin: 'dark',
        icon: <HorizontalTimeline.CompleteIcon />,
      },
      {
        label: 'Domain check',
        skin: 'dark',
        icon: <HorizontalTimeline.ActiveIcon />,
      },
      { label: 'Domain connecting' },
      { label: 'Site is live worldwide' },
    ]}
  />
</div>;
```

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\`.

```jsx
<HorizontalTimeline
  items={[{ label: 'Item 1' }, { label: 'Item 2' }, { label: 'Item 3' }]}
/>;
```

#### 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.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <HorizontalTimeline
    items={[
      {
        label: 'Center',
        icon: <HorizontalTimeline.DefaultIcon />,
      },
      {
        label: 'Center',
        icon: <HorizontalTimeline.DefaultIcon />,
      },
    ]}
  />
  <HorizontalTimeline
    alignLabel="start"
    items={[
      {
        label: 'Start',
        icon: <HorizontalTimeline.DefaultIcon />,
      },
      {
        label: 'Start',
        icon: <HorizontalTimeline.DefaultIcon />,
      },
    ]}
  />
</StorybookComponents.Stack>;
```

#### 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.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <HorizontalTimeline
    skin="dark"
    items={[
      {
        label: 'Completed',
        line: 'filled',
        icon: <HorizontalTimeline.CompleteIcon />,
      },
      {
        label: 'Active',
        line: 'filled',
        icon: <HorizontalTimeline.ActiveIcon />,
      },
      {
        label: 'Upcoming',
        icon: <HorizontalTimeline.DefaultIcon />,
      },
    ]}
  />
  <HorizontalTimeline
    skin="standard"
    items={[
      {
        label: 'Completed',
        line: 'filled',
        icon: <HorizontalTimeline.CompleteIcon skin="standard" />,
      },
      {
        label: 'Active',
        line: 'filled',
        icon: <HorizontalTimeline.ActiveIcon skin="standard" />,
      },
      {
        label: 'Upcoming',
        icon: <HorizontalTimeline.DefaultIcon skin="standard" />,
      },
    ]}
  />
</StorybookComponents.Stack>;
```

#### 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.

```jsx
<HorizontalTimeline
  items={[
    { label: 'Item 1', line: 'filled' },
    { label: 'Item 2', line: 'filled' },
    { label: 'Item 3', line: 'filled' },
    { label: 'Item 4' },
    { label: 'Item 5' },
  ]}
/>;
```

#### 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.

```jsx
<HorizontalTimeline
  items={[
    {
      label: 'Item 1',
      icon: <HorizontalTimeline.BoundaryIcon />,
    },
    {
      label: 'Item 2',
      icon: <HorizontalTimeline.ActiveIcon />,
    },
    {
      label: 'Item 3',
      icon: <HorizontalTimeline.CompleteIcon />,
    },
    {
      label: 'Item 4',
      icon: <HorizontalTimeline.DestructiveIcon />,
    },
    {
      label: 'Item 5',
      icon: <HorizontalTimeline.DefaultIcon />,
    },
  ]}
/>;
```

### 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.

```jsx
<HorizontalTimeline
  items={[
    {
      label: 'You completed the steps',
      line: 'filled',
      icon: <HorizontalTimeline.CompleteIcon />,
    },
    {
      label: "We're checking your domain",
      line: 'filled',
      icon: <HorizontalTimeline.ActiveIcon />,
    },
    {
      label: 'Your domain is connecting',
    },
    {
      label: 'Your site is live worldwide',
    },
  ]}
/>;
```

## Code

```jsx
import { HorizontalTimeline } from '@wix/design-system';
```

### Props

| 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. |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { HorizontalTimelineUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { HorizontalTimelineTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { HorizontalTimelineTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { HorizontalTimelineTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| 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. |

## 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](invalid-url))
- **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](invalid-url))
- **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