> 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: Timeline Component

## Article: Timeline Component

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

## Article Content:

# Timeline

_Components/Lists/Timeline_

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

## Overview

```jsx
() => {
  const items = [
    {
      label: 'Site member blocked',
      suffix: 'Nov 6, 2021, 9:05 AM',
    },
    {
      label: 'Sent Quote: #1',
      labelAction: <TextButton size="small">View</TextButton>,
      suffix: 'Nov 3, 2021, 1:43 PM',
    },
    {
      label: 'Contact was created via Site Members',
      suffix: 'Oct 18, 2021, 5:19 PM',
    },
  ];

  return <Timeline items={items} />;
};
```

Timeline displays a vertical list of past events in a chronological order.

### Do

- Use it to log and illustrate a history of events (newest on top, oldest at the bottom).
- Use it when the list of events is actionable (e.g., user can view event's documents).

### Don't

- Don't use it to demonstrate the progress of server states or to show task SLA status. Use `<HorizontalTimeline/>` instead.
- Don't use it as part of an onboarding flow. Use `<Stepper/>` component instead.

### Feature examples

#### Structure

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.

```jsx
() => {
  const items = [
    {
      label: (
        <StorybookComponents.Placeholder>Label</StorybookComponents.Placeholder>
      ),
      labelAction: (
        <StorybookComponents.Placeholder>
          Label action
        </StorybookComponents.Placeholder>
      ),
      suffix: (
        <StorybookComponents.Placeholder>
          Suffix
        </StorybookComponents.Placeholder>
      ),
      customPrefix: (
        <StorybookComponents.Placeholder>
          Custom Prefix
        </StorybookComponents.Placeholder>
      ),
    },
  ];

  return <Timeline items={items} />;
};
```

#### Gap

Control vertical distance between the items with a \`gap\` prop.\
\
Default value is 30 px.

```jsx
() => {
  const items = [
    {
      label: 'Item 1',
    },
    {
      label: 'Item 2',
    },
  ];

  return (
    <StorybookComponents.Stack>
      <Timeline items={items} />
      <Timeline items={items} gap="60px" />
    </StorybookComponents.Stack>
  );
};
```

#### Label

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.

```jsx
() => {
  const items = [
    {
      label: 'Label',
    },
    {
      label:
        'Label that is very long and does not fit into a single line, so it wraps into multiple lines, since the Timeline component has to fit into its parent container',
    },
  ];

  return <Timeline items={items} />;
};
```

#### Label action

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.

```jsx
() => {
  const items = [
    {
      label: 'Label',
      labelAction: <TextButton size="small">Label action</TextButton>,
    },
    {
      labelAction: (
        <TextButton size="small">Label action without a Label</TextButton>
      ),
    },
  ];

  return <Timeline items={items} />;
};
```

#### Custom Prefix

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.

```jsx
() => {
  const items = [
    {
      label: 'Without custom Prefix',
    },
    {
      label: 'With custom Prefix',
      customPrefix: <Icons.StatusCompleteSmall />,
    },
  ];

  return <Timeline items={items} />;
};
```

#### Suffix

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

```jsx
() => {
  const items = [
    {
      label: 'Item 1',
      suffix: 'Suffix as a text',
    },
    {
      label: 'Item 2',
      suffix: <Badge skin="neutral">Suffix as a component</Badge>,
    },
  ];

  return <Timeline items={items} />;
};
```

### Common use case examples

#### Store Order Activity

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.

```jsx
() => {
  const initialItems = [
    {
      label: (
        <Box gap="2">
          <Text size="small">Invoice created</Text>
          <BadgeSelect
            type="outlined"
            size="small"
            options={[
              { id: '0', skin: 'neutral', text: 'waiting for payment' },
              { id: '1', skin: 'success', text: 'paid in full' },
              { id: '2', skin: 'warning', text: 'paid in part' },
              { id: '3', skin: 'danger', text: 'payment is due' },
            ]}
          />
        </Box>
      ),
      labelAction: <TextButton size="small">View Invoice</TextButton>,
      suffix: 'Aug 12, 2021',
    },
    {
      label: 'Digital product links sent to John',
      suffix: 'Aug 9, 2021',
    },
    {
      label: 'Order marked as Fulfilled',
      suffix: 'Aug 9, 2021',
    },
    {
      label: 'Order marked as Paid',
      suffix: 'Aug 9, 2021',
    },
    {
      label: 'John placed an order',
      labelAction: <TextButton size="small">View Order Summary</TextButton>,
      suffix: 'Aug 8, 2021',
    },
  ];
  const [items, setItems] = React.useState(initialItems);

  const addNode = (value) => {
    setItems([{ label: value, suffix: 'Today' }, ...items]);
  };

  return (
    <Card>
      <Card.Header title="Order Activity" />
      <Card.Divider />
      <Card.Content>
        <Timeline
          items={[
            {
              label: (
                <FormField label="Add a note (your customers will not see this)">
                  <ListItemEditable
                    onApprove={(value) => addNode(value)}
                    onCancel={() => {}}
                    placeholder="Activity Note"
                    cancelButtonTooltipContent="Cancel"
                    approveButtonTooltipContent="Approve"
                    size="small"
                    margins="none"
                  />
                </FormField>
              ),
              suffix: 'Today',
            },
            ...items,
          ]}
        />
      </Card.Content>
    </Card>
  );
};
```

## Code

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

### Props

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

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

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

## Changelog

- **1.344.0** (2026-10-28) — maintenance release, no component-specific changes
- **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.331.0** (2026-10-01) — 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.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 ([#15948](invalid-url))
- **1.254.0** (2026-02-03) — maintenance release, no component-specific changes
- **1.154.0** (2025-01-16) — feat: add skin and line properties, support medium size icons as prefix ([#14436](invalid-url))
- **1.148.0** (2024-12-16) — 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