Overview
Go Headless

Changelog

Wix Design System (WDS)
Introduction
About Wix Design System
Get started developing
Get started designing
Theming
Wix Design System AI

Guidelines
Themes
Interaction & Behavior
Guidelines
Localization

Patterns
Patterns Overview
Table Pattern
Grid Switch Pattern
Grid Pattern

Foundations
Tokens and Theming basics
Icon Theming

Contributing
AI-Assisted Development
Component Structure
Contributing to Wix Design System
Creating a New Component
Creating a Pull Request
Deprecating a Component
Documenting
Fixing a Bug
Test Drivers
Contributing Tokens
Token Migration Guidelines
Updating Props
Writing Tests

Components
Actions
Animations
Charts
Feedback
Form
Layout
Lists
Mechanisms
Media
Navigation
Breadcrumbs Component
ComposerHeader
Pagination Component
SidebarDividerNext
SidebarDividerNext Component
SidebarHeaderNext Component
SidebarItemNext Component
SidebarNext Component
SidebarSubMenuNext Component
SidebarTitleItemNext Component
Stepper Component
Tabs Component
VerticalTabs
Overlays
Panels
Typography
In This Article

  1. Overview
  2. Code
  3. Testkit
  4. Changelog

SidebarNext

Components/Navigation/Sidebar

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

Overview

Copy

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.

Copy

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.

Copy

Skeleton

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

Copy

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.

Copy

Toggle sidebar's visibility

Set the sidebar as visible or hidden using hidden prop.

Copy

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.

Copy

Code

Copy

Props

NameTypeDefaultDescription
ariaLabelstring—Defines a string that labels the sidebar for screen readers.
childrenReactNode—Sets the items rendered inside the sidebar.
classNamestring—Specifies a CSS class name to be appended to the component's root element.
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
enableMinimizeToggleboolean—Displays a toggle that lets users minimize and restore the sidebar.
footerReactNode—Sets the content rendered below the sidebar items.
headerReactNode—Sets the content rendered above the sidebar items.
hiddenboolean—Specifies whether the sidebar is hidden.
isLoadingbooleantrueDisplays a loading skeleton in place of the sidebar items.
minimizedboolean—Specifies whether the sidebar is collapsed to its minimized form.
minimizeToggleTooltipstring—Sets the tooltip content of the minimize toggle.
nextboolean—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.
selectedKeystring—Sets the key of the currently selected item.
skin"light" | "neutral" | "dark"'dark'Controls the color scheme of the sidebar.
widthstring | number—Sets the width of the sidebar.
zIndexnumber—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) — 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)
  • 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) — 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) — 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) — 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) — 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) — 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) — 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)
  • 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)
  • 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)
  • 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)
  • 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)
  • 1.97.0 (2024-02-26) — feat: add tooltip when hover on 1st level single item (#13295)
  • 1.95.1 (2024-02-19) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 21 October 2026

Did this help?