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

## Article: VerticalTabs Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/navigation/vertical-tabs/vertical-tabs-component.md

## Article Content:

# VerticalTabs

_Components/Navigation/Verticaltabs_

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

## Overview

```jsx
<Box direction="vertical" align="center">
  <div style={{ width: 260 }}>
    <VerticalTabs onChange={(/*id*/) => {}}>
      <VerticalTabs.TabsGroup title="Categories">
        <VerticalTabs.TabItem>Marketing</VerticalTabs.TabItem>
        <VerticalTabs.TabItem>Sell Online</VerticalTabs.TabItem>
        <VerticalTabs.TabItem>Services & Events</VerticalTabs.TabItem>
        <VerticalTabs.TabItem>Media & Content</VerticalTabs.TabItem>
        <VerticalTabs.TabItem>Design Elements</VerticalTabs.TabItem>
      </VerticalTabs.TabsGroup>
    </VerticalTabs>
  </div>
</Box>;
```

Vertical tabs let users vertically navigate between different content sections within a page, card, or panel.

### Do

- Use it to organize multiple content sections within the same context.
- Use short and descriptive tab titles.

### Don't

- Don't use it to show the path users need to follow to complete a process. Use `<Stepper/>` instead.
- Don't place critical navigation elements within tabs.
- Don't make the user click back and forth on the different tabs to complete a single task.

### Feature examples

#### Size

Control the tab size with the `size` prop:

- `medium` (default) is the standard used in common cases.
- `small` fits into smaller elements and compact designs.
- `tiny` is used for dense layouts.

```jsx
<StorybookComponents.Stack flexDirection="column" width="200px">
  <VerticalTabs onChange={(/*id*/) => {}}>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Medium tab 1
    </VerticalTabs.TabItem>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Medium tab 2
    </VerticalTabs.TabItem>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Medium tab 3
    </VerticalTabs.TabItem>
  </VerticalTabs>
  <VerticalTabs size="small" onChange={(/*id*/) => {}}>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Small tab 1
    </VerticalTabs.TabItem>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Small tab 2
    </VerticalTabs.TabItem>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Small tab 3
    </VerticalTabs.TabItem>
  </VerticalTabs>
  <VerticalTabs size="tiny" onChange={(/*id*/) => {}}>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Tiny tab 1
    </VerticalTabs.TabItem>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Tiny tab 2
    </VerticalTabs.TabItem>
    <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
      Tiny tab 3
    </VerticalTabs.TabItem>
  </VerticalTabs>
</StorybookComponents.Stack>;
```

#### Skin

`skin` controls the overall visual style of the `VerticalTabs` container and items.

- `standard` (default)
- `light`
- `neutral`

```jsx
() => {
  const [activeTabs, setActiveTabs] = React.useState({
    standard: 0,
    light: 0,
    neutral: 0,
  });

  const tabItems = [
    { id: 0, label: 'Overview' },
    { id: 1, label: 'Settings' },
    { id: 2, label: 'Billing' },
  ];

  return (
    <Box gap="20px" direction="vertical">
      <Box direction="horizontal" gap="20px">
        <Box width="220px" gap="20px" direction="vertical">
          <Text>Standard</Text>
          <VerticalTabs
            skin="standard"
            activeTabId={activeTabs.standard}
            onChange={(tabId) =>
              setActiveTabs((prevTabs) => ({ ...prevTabs, standard: tabId }))
            }
          >
            {tabItems.map((item) => (
              <VerticalTabs.TabItem key={item.id} id={item.id}>
                {item.label}
              </VerticalTabs.TabItem>
            ))}
          </VerticalTabs>
        </Box>

        <Box width="220px" gap="20px" direction="vertical">
          <Text>Light</Text>
          <VerticalTabs
            skin="light"
            activeTabId={activeTabs.standard}
            onChange={(tabId) =>
              setActiveTabs((prevTabs) => ({ ...prevTabs, standard: tabId }))
            }
          >
            {tabItems.map((item) => (
              <VerticalTabs.TabItem key={item.id} id={item.id}>
                {item.label}
              </VerticalTabs.TabItem>
            ))}
          </VerticalTabs>
        </Box>

        <Box width="220px" gap="20px" direction="vertical">
          <Text>Neutral</Text>
          <VerticalTabs
            skin="neutral"
            activeTabId={activeTabs.standard}
            onChange={(tabId) =>
              setActiveTabs((prevTabs) => ({ ...prevTabs, standard: tabId }))
            }
          >
            {tabItems.map((item) => (
              <VerticalTabs.TabItem key={item.id} id={item.id}>
                {item.label}
              </VerticalTabs.TabItem>
            ))}
          </VerticalTabs>
        </Box>
      </Box>
    </Box>
  );
};
```

#### Group title

Group related tabs together under a title by using a `<VerticalTabs.TabsGroup/>` wrapper.

```jsx
<div style={{ width: 200 }}>
  <VerticalTabs onChange={(/*id*/) => {}}>
    <VerticalTabs.TabsGroup title="Group Title">
      <VerticalTabs.TabItem>Tab 1</VerticalTabs.TabItem>
      <VerticalTabs.TabItem>Tab 2</VerticalTabs.TabItem>
      <VerticalTabs.TabItem>Tab 3</VerticalTabs.TabItem>
    </VerticalTabs.TabsGroup>
  </VerticalTabs>
</div>;
```

#### Selected tab

Specify which tab is currently selected with the `activeTabId` prop.

```jsx
<div style={{ width: 200 }}>
  <VerticalTabs activeTabId={0} onChange={(/*id*/) => {}}>
    <VerticalTabs.TabsGroup title="Group Title">
      <VerticalTabs.TabItem id={0}>Tab 1</VerticalTabs.TabItem>
      <VerticalTabs.TabItem id={1}>Tab 2</VerticalTabs.TabItem>
      <VerticalTabs.TabItem id={2}>Tab 3</VerticalTabs.TabItem>
    </VerticalTabs.TabsGroup>
  </VerticalTabs>
</div>;
```

### Common use case examples

#### Sidebar in a custom modal

Place tabs inside a `</CustomModalLayout>` to create a sidebar with structured content.

```jsx
<CustomModalLayout
  showFooterDivider
  showHeaderDivider
  primaryButtonText="Save"
  secondaryButtonText="Cancel"
  onCloseButtonClick={() => {}}
  title="Account settings"
  removeContentPadding
  content={
    <Box>
      <Box width="200px" direction="vertical" paddingBottom="16px">
        <VerticalTabs size="small" onChange={(/*id*/) => {}}>
          <VerticalTabs.TabsGroup title="Settings">
            <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
              Account info
            </VerticalTabs.TabItem>
            <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
              Login info
            </VerticalTabs.TabItem>
            <VerticalTabs.TabItem suffixIcon={<Icons.ChevronRight />}>
              Email preferences
            </VerticalTabs.TabItem>
          </VerticalTabs.TabsGroup>
        </VerticalTabs>
      </Box>
      <Divider direction="vertical"></Divider>
    </Box>
  }
/>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `activeTabId` | `TabId` | — | Current selected tab id. |
| `children` | `ReactNode` | — | Child nodes of this component must be of type <code><VerticalTabs.TabsGroup></code> or <code><VerticalTabs.Footer></code> |
| `dataHook` | `string` | — | Data attribute for testing purposes. |
| `ellipsis` | `boolean` | — | Makes all text items into ellipsis when overflowing. |
| `maxWidth` | `string` | — | Container max width. |
| `onChange` | `(id: TabId) => void` | — | Callback function called on tab selection change with the following parameters<code>(id)</code> |
| `size` | `"small" \| "tiny" \| "medium"` | — | Text Size (tiny, small, medium) |
| `skin` | `"standard" \| "light" \| "neutral"` | — | Specifies the skin of a TabItem. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getActiveTabId` | — |
| `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) — breaking: in Harmony (odeditor), items have no background at rest or when disabled; hover and selected backgrounds are unchanged. ([#17548](invalid-url)) — has visual 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.328.0** (2026-09-22) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.320.0** (2026-09-03) — 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.273.0** (2026-04-30) — fix: action items wrapper added for padding ([#16217](invalid-url)) — has visual changes
- **1.269.0** (2026-04-15) — fix: word-break changed to break-word, not break-all ([#16145](invalid-url)) — has visual changes
- **1.267.0** (2026-04-09) — feat: maxwidth and ellipsis props ([#16124](invalid-url)) — has visual 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.254.0** (2026-02-03) — maintenance release, no component-specific changes
- **1.213.0** (2025-08-19) — maintenance release, no component-specific changes
- **1.169.0** (2025-03-10) — maintenance release, no component-specific changes
- **1.158.0** (2025-02-04) — maintenance release, no component-specific changes
- **1.139.0** (2024-11-07) — feat: neutral and premium skins ([#14260](invalid-url))
- **1.133.0** (2024-10-14) — maintenance release, no component-specific changes
- **1.131.0** (2024-10-10) — maintenance release, no component-specific changes
- **1.130.0** (2024-10-02) — feat: introduce id and activeId suport as string ([#14192](invalid-url))
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.93.0** (2024-02-08) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes