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

## Article: SidebarNext Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/navigation/sidebar-divider-next/sidebar-next-component.md

## Article Content:

# SidebarNext

_Components/Navigation/Sidebar_

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

## Overview

```jsx
() => {
  const [selectedKey, setSelectedKey] = React.useState('1');

  return (
    <StorybookComponents.Stack height="500px">
      <SidebarNext
        header={
          <SidebarHeaderNext
            title="Let's setup the site"
            subtitle={
              <TextButton
                skin="light"
                size="tiny"
                suffixIcon={
                  <Box
                    height="15px"
                    width="18px"
                    marginTop="2px"
                    verticalAlign="middle"
                  >
                    <Icons.ChevronRightSmall />
                  </Box>
                }
              >
                View all steps
              </TextButton>
            }
          ></SidebarHeaderNext>
        }
        footer={
          <Box width="100%" align="center" padding="18px 0px">
            <TextButton
              size="small"
              skin="light"
              prefixIcon={<Icons.QuickAccessSmall />}
            >
              Quick Access
            </TextButton>
          </Box>
        }
        selectedKey={selectedKey}
        isLoading={false}
      >
        <SidebarItemNext itemKey="1" onClick={() => setSelectedKey('1')}>
          Home
        </SidebarItemNext>
        <SidebarItemNext itemKey="2" onClick={() => setSelectedKey('2')}>
          Activity
        </SidebarItemNext>
        <SidebarDividerNext />
        <SidebarSubMenuNext
          title="Contacts"
          itemKey="3"
          onClick={() => setSelectedKey('3-1')}
        >
          <SidebarItemNext itemKey="3-1" onClick={() => setSelectedKey('3-1')}>
            Contacts
          </SidebarItemNext>
          <SidebarItemNext itemKey="3-2" onClick={() => setSelectedKey('3-2')}>
            Segments
          </SidebarItemNext>
          <SidebarItemNext itemKey="3-3" onClick={() => setSelectedKey('3-3')}>
            Site Members
          </SidebarItemNext>
          <SidebarItemNext itemKey="3-4" onClick={() => setSelectedKey('3-4')}>
            Workflows
          </SidebarItemNext>
        </SidebarSubMenuNext>
        <SidebarItemNext itemKey="4" onClick={() => setSelectedKey('4')}>
          Communications
        </SidebarItemNext>
        <SidebarItemNext itemKey="5" onClick={() => setSelectedKey('5')}>
          Automations
        </SidebarItemNext>
        <SidebarDividerNext />
        <SidebarItemNext itemKey="6" onClick={() => setSelectedKey('6')}>
          Settings
        </SidebarItemNext>
      </SidebarNext>
    </StorybookComponents.Stack>
  );
};
```

SidebarNext is a major navigation element for Business Manager or Account level applications.

### Do

- Use it to create a navigation between Business Manager applications.
- Use it to create a navigation in various content management systems.

### Don't

- Don't use it to tab between sections. Use `<Tabs/>` or `<VerticalTabs/>` component instead.

### Feature examples

#### Structure

This component consists of 3 containers:

\- `header` - use it to display application name or to reflect application setup progress.

\- `children` - use it to list all navigation elements linking to all major application pages.

\- `footer` - use it for a special call to action.

Header and footer containers are always sticky.

```jsx
() => {
  const placeholder = (children, height) => (
    <StorybookComponents.Placeholder width="100%" height={height} skin="light">
      {children}
    </StorybookComponents.Placeholder>
  );

  return (
    <StorybookComponents.Stack height="204px">
      <SidebarNext
        header={placeholder('Header', '42px')}
        footer={placeholder('Footer', '42px')}
        isLoading={false}
      >
        {placeholder('Children', '120px')}
      </SidebarNext>
    </StorybookComponents.Stack>
  );
};
```

#### Skin

Control the sidebar's style with `skin` prop:

\- `dark` (default) - used in _Business Manager_ application.

\- `light` - used in _My Account_ application.

\- `neutral` - used in _Media Manager_.

```jsx
<StorybookComponents.Stack height="90px">
  <SidebarNext skin="dark" selectedKey="1-2" isLoading={false}>
    <SidebarItemNext itemKey="1-1">Dark option 1</SidebarItemNext>
    <SidebarItemNext itemKey="1-2">Dark option 2</SidebarItemNext>
  </SidebarNext>
  <SidebarNext skin="light" selectedKey="1-2" isLoading={false}>
    <SidebarItemNext itemKey="1-1">Light option 1</SidebarItemNext>
    <SidebarItemNext itemKey="1-2">Light option 2</SidebarItemNext>
  </SidebarNext>
  <SidebarNext skin="neutral" selectedKey="1-2" isLoading={false}>
    <SidebarItemNext itemKey="1-1">Neutral option 1</SidebarItemNext>
    <SidebarItemNext itemKey="1-2">Neutral option 2</SidebarItemNext>
  </SidebarNext>
</StorybookComponents.Stack>;
```

#### Skeleton

Toggle component's loading state with `isLoading` prop. Prop's default value is `true`.

```jsx
<StorybookComponents.Stack height="270px">
  <SidebarNext
    isLoading={true}
    header={
      <StorybookComponents.Placeholder width="100%" height="42px" skin="light">
        Header
      </StorybookComponents.Placeholder>
    }
    footer={
      <StorybookComponents.Placeholder width="100%" height="42px" skin="light">
        Footer
      </StorybookComponents.Placeholder>
    }
  />
</StorybookComponents.Stack>;
```

### Developer examples

#### Control selected state

Control which sidebar option is selected by passing a key number with `selectedKey` prop in `<SidebarNext/>` component.

Specify each sidebar option's key number with `itemKey` prop in `<SidebarItemNext/>` component.

```jsx
() => {
  const [selectedKey, setSelectedKey] = React.useState('2');

  return (
    <Box height="120px">
      <SidebarNext isLoading={false} selectedKey={selectedKey}>
        <SidebarItemNext itemKey="1" onClick={() => setSelectedKey('1')}>
          Option 1
        </SidebarItemNext>
        <SidebarItemNext itemKey="2" onClick={() => setSelectedKey('2')}>
          Option 2
        </SidebarItemNext>
        <SidebarItemNext itemKey="3" onClick={() => setSelectedKey('3')}>
          Option 3
        </SidebarItemNext>
      </SidebarNext>
    </Box>
  );
};
```

#### Toggle sidebar's visibility

Set the sidebar as visible or hidden using `hidden` prop.

```jsx
() => {
  const [selectedKey, setSelectedKey] = React.useState('1');
  const [hidden, setHidden] = React.useState(false);

  return (
    <Box overflow="hidden">
      <StorybookComponents.Stack height="264px">
        <SidebarNext
          selectedKey={selectedKey}
          isLoading={false}
          hidden={hidden}
        >
          <StorybookComponents.Placeholder skin="light" height="240px">
            Children
          </StorybookComponents.Placeholder>
        </SidebarNext>
        <Button onClick={() => setHidden(!hidden)}>Toggle Sidebar</Button>
      </StorybookComponents.Stack>
    </Box>
  );
};
```

### Common use case examples

#### Sidebar in composer application

Some applications like many Wix composers require a lot of horizontal space to make the app effective.

Therefore it's allowed to add an additional action in the composer header allowing to toggle sidebar's visibility.

```jsx
() => {
  const [selectedKey, setSelectedKey] = React.useState('5');
  const [hidden, setHidden] = React.useState(false);

  return (
    <Box overflow="hidden" height="500px">
      <Box>
        <SidebarNext
          selectedKey={selectedKey}
          isLoading={false}
          hidden={hidden}
          header={
            <SidebarHeaderNext
              title="Let's setup the site"
              subtitle={
                <TextButton
                  skin="light"
                  size="tiny"
                  suffixIcon={
                    <Box
                      height="15px"
                      width="18px"
                      marginTop="2px"
                      verticalAlign="middle"
                    >
                      <Icons.ChevronRightSmall />
                    </Box>
                  }
                >
                  View all steps
                </TextButton>
              }
            ></SidebarHeaderNext>
          }
          footer={
            <Box width="100%" align="center" padding="18px 0px">
              <TextButton
                size="small"
                skin="light"
                prefixIcon={<Icons.QuickAccessSmall />}
              >
                Quick Access
              </TextButton>
            </Box>
          }
        >
          <SidebarItemNext itemKey="1" onClick={() => setSelectedKey('1')}>
            Home
          </SidebarItemNext>
          <SidebarItemNext itemKey="2" onClick={() => setSelectedKey('2')}>
            Activity
          </SidebarItemNext>
          <SidebarDividerNext />
          <SidebarSubMenuNext
            title="Contacts"
            itemKey="3"
            onClick={() => setSelectedKey('3-1')}
          >
            <SidebarItemNext
              itemKey="3-1"
              onClick={() => setSelectedKey('3-1')}
            >
              Contacts
            </SidebarItemNext>
            <SidebarItemNext
              itemKey="3-2"
              onClick={() => setSelectedKey('3-2')}
            >
              Segments
            </SidebarItemNext>
            <SidebarItemNext
              itemKey="3-3"
              onClick={() => setSelectedKey('3-3')}
            >
              Site Members
            </SidebarItemNext>
            <SidebarItemNext
              itemKey="3-4"
              onClick={() => setSelectedKey('3-4')}
            >
              Workflows
            </SidebarItemNext>
          </SidebarSubMenuNext>
          <SidebarItemNext itemKey="4" onClick={() => setSelectedKey('4')}>
            Communications
          </SidebarItemNext>
          <SidebarItemNext itemKey="5" onClick={() => setSelectedKey('5')}>
            Automations
          </SidebarItemNext>
          <SidebarDividerNext />
          <SidebarItemNext itemKey="6" onClick={() => setSelectedKey('6')}>
            Settings
          </SidebarItemNext>
        </SidebarNext>
      </Box>
      <Box direction="vertical" width="100%">
        <ComposerHeader>
          <ComposerHeader.Actions>
            <TextButton
              skin="dark"
              size="small"
              prefixIcon={
                !hidden ? (
                  <Icons.HideSidebarSmall />
                ) : (
                  <Icons.ShowSidebarSmall />
                )
              }
              onClick={() => setHidden(!hidden)}
            >
              {!hidden ? 'Hide sidebar' : 'Show sidebar'}
            </TextButton>
          </ComposerHeader.Actions>
        </ComposerHeader>
        <Box margin="6px 6px 0px 6px" height="100%">
          <StorybookComponents.Placeholder>
            Page content
          </StorybookComponents.Placeholder>
        </Box>
      </Box>
    </Box>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `ariaLabel` | `string` | — | Defines a string that labels the sidebar for screen readers. |
| `children` | `ReactNode` | — | Sets the items rendered inside the sidebar. |
| `className` | `string` | — | Specifies a CSS class name to be appended to the component's root element. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `enableMinimizeToggle` | `boolean` | — | Displays a toggle that lets users minimize and restore the sidebar. |
| `footer` | `ReactNode` | — | Sets the content rendered below the sidebar items. |
| `header` | `ReactNode` | — | Sets the content rendered above the sidebar items. |
| `hidden` | `boolean` | — | Specifies whether the sidebar is hidden. |
| `isLoading` | `boolean` | `true` | Displays a loading skeleton in place of the sidebar items. |
| `minimized` | `boolean` | — | Specifies whether the sidebar is collapsed to its minimized form. |
| `minimizeToggleTooltip` | `string` | — | Sets the tooltip content of the minimize toggle. |
| `next` | `boolean` | — | Applies the current styling to sidebars that are only 1 or 2 levels deep, which are otherwise rendered in the legacy style. |
| `onMinimizeToggleClick` | `() => void` | — | Defines a callback function which is called when the minimize toggle is clicked. |
| `selectedKey` | `string` | — | Sets the key of the currently selected item. |
| `skin` | `"light" \| "neutral" \| "dark"` | `'dark'` | Controls the color scheme of the sidebar. |
| `width` | `string \| number` | — | Sets the width of the sidebar. |
| `zIndex` | `number` | — | Sets the `z-index` of the sidebar. |

## Testkit

No testkit for this component — it doesn't expose a unidriver testkit.

## Changelog

- **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.330.0** (2026-09-28) — maintenance release, no component-specific changes
- **1.329.0** (2026-09-24) — maintenance release, no component-specific changes
- **1.328.0** (2026-09-22) — maintenance release, no component-specific changes
- **1.327.0** (2026-09-21) — fix: the item list is now a single tab stop. Tab focuses the selected item (or the first one), ArrowUp/ArrowDown/Home/End move between the visible items, and the next Tab lands in the footer. Keyboard-focused items show the focus ring again. ([#17107](invalid-url)) — has visual changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.322.0** (2026-09-09) — maintenance release, no component-specific changes
- **1.318.0** (2026-08-28) — fix: when collapsing, the content now switches to its minimized layout as the width animation starts, mirroring how expanding already works, instead of snapping to it about 200ms after the animation ends. ([#16918](invalid-url))
- **1.317.1** (2026-08-26) — fix: in the Harmony (odeditor) theme the header, content and footer sections now match the BM Reimagined spec — 12px start / 14px end padding, and a fixed 16px gap between the header and the first item that scrolling content no longer collapses. Other themes are unchanged. ([#16892](invalid-url)) — has visual changes
- **1.317.0** (2026-08-26) — maintenance release, no component-specific changes
- **1.313.1** (2026-08-18) — fix: in the Harmony (odeditor) theme the sidebar's right edge shows two 1px lines — an inner `#FFFFFF` hairline next to an outer `#EEEEEE` line. Adds `--wds-sidebar-border-inner-fill` and `--wds-sidebar-border-outer-fill` (set only in Harmony; unset elsewhere, so other themes keep their single divider border). ([#16746](invalid-url)) — has visual changes
- **1.313.1** (2026-08-18) — fix: restore the Default theme to its pre-1.308.1 appearance (1.308.1 unintentionally changed Default sidebar item indents, paddings, typography and the quick-navigation popover). Default now matches 1.307.0 again. In Harmony (odeditor) a minimized sidebar item is a centred 30x30 icon button (was 34x30). Studio 2.0 (odeditor-dark) and other themes are unchanged. ([#16746](invalid-url)) — has visual changes
- **1.313.1** (2026-08-18) — fix: in the Harmony (odeditor) theme the sidebar now has an opaque surface background, and scrolling content softly fades out just above the sticky footer. The footer's first item is spaced clear of the fade, and the scroll area gains matching bottom room so no items stay hidden behind it. When no footer is provided, neither the fade nor the reserved space is shown. Other themes are unchanged. ([#16746](invalid-url)) — has visual changes
- **1.313.1** (2026-08-18) — fix: the quick-navigation popover now sits flush against its anchor instead of a few pixels away, and a transparent hover bridge keeps it open while the pointer moves from the item onto it (it could otherwise close on a slow diagonal move). ([#16746](invalid-url)) — has visual changes
- **1.313.1** (2026-08-18) — fix: in the Harmony (odeditor) theme an expanded second-level sub-menu no longer adds 6px of bottom padding. Adds `--wds-sidebar-submenu-level-2-padding-bottom` (`0` in Harmony, `6px` — the previous value — everywhere else). Other themes are unchanged. ([#16746](invalid-url)) — has visual changes
- **1.311.0** (2026-08-12) — fix: the sub-menu quick-navigation popover now opens flush against the sidebar instead of 10px away. ([#16784](invalid-url))
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.308.1** (2026-08-05) — maintenance release, no component-specific changes
- **1.307.0** (2026-08-03) — maintenance release, no component-specific changes
- **1.297.0** (2026-07-09) — maintenance release, no component-specific changes
- **1.295.0** (2026-07-03) — 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) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.265.0** (2026-04-02) — maintenance release, no component-specific changes
- **1.260.1** (2026-03-23) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.250.0** (2026-01-27) — maintenance release, no component-specific changes
- **1.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.228.0** (2025-11-18) — maintenance release, no component-specific changes
- **1.222.0** (2025-10-23) — fix: fix tooltip text in sidebar for light skin ([#15434](invalid-url))
- **1.119.0** (2024-07-31) — maintenance release, no component-specific changes
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.108.0** (2024-06-03) — maintenance release, no component-specific changes
- **1.104.1** (2024-05-14) — maintenance release, no component-specific changes
- **1.104.0** (2024-05-06) — maintenance release, no component-specific changes
- **1.103.2** (2024-04-24) — fix: next prop testkit didnt work ([#13650](invalid-url))
- **1.103.1** (2024-04-24) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.101.0** (2024-04-12) — fix: removed native focus style ([#13607](invalid-url))
- **1.99.1** (2024-04-02) — maintenance release, no component-specific changes
- **1.99.0** (2024-03-29) — feat: add next prop to define if to use the new design ([#13511](invalid-url))
- **1.97.0** (2024-02-26) — feat: add tooltip when hover on 1st level single item ([#13295](invalid-url))
- **1.95.1** (2024-02-19) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes