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

SidebarSubMenuNext

Components/Navigation/Sidebar

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

Overview

Copy

SidebarSubMenuNext allows to put a list of options into a collapsible group. This component is part of SidebarNext component.

Do

  • Use it to build <SidebarNext/> navigation

Don't

  • Don't use it as a stand alone component

Feature examples

Structure

Component consists of 2 containers:

- title - use it do display sub item's label.

- children - use it do display item's child actions.

Copy

Suffix

Add a counter badge or other indication after the item's label using suffix prop.

Copy

Disabled

Control item's interaction with disabled prop. Disable item when it's unavailable, but has to remain visible.

Copy

Developer examples

Custom HTML tag

Render action as any given HTML tag with as prop. For example it can be rendered as:

<a> - use when attributes like href, target, etc., are needed.

<Link> - use this react router item to have props like to, replace, etc.

All attributes will be passed to the rendered element.

Link works only if any of inner elements are NOT selected.

Copy

Setup selection with sidebar

Control item selection from Sidebar component referring to itemKey set value.

Truncate children item's text with isInQuickNavigation prop.

Copy

Common use case examples

Navigating between items

Redirect <SidebarSubMenuNext/> selection to its first child when clicked. It helps a user to understand sidebar's hierarchy and navigate between the items easily.

Copy

Code

Copy

Props

NameTypeDefaultDescription
as"button"'button'Renders the submenu trigger as another HTML tag or component.
childrenReactNode—Sets the items nested under this submenu.
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
disabledboolean—Indicates whether to display the item as disabled.
hrefstring—URL of the page that link goes to.
itemKeystring—Sets a unique key for the submenu. The submenu is marked as selected and expanded when it or one of its nested items matches the selectedKey of <SidebarNext/>, and the key is passed to onClick as the second argument.
onClickMouseEventHandler—A callback to be triggered on click.
onCollapse(trigger: ExpandCollapseTrigger) => void—A callback to be triggered when the sub menu collapses.
onExpand(trigger: ExpandCollapseTrigger) => void—A callback to be triggered when the sub menu expands.
onQuickNavOpen() => void—A callback to be triggered when the quick nav opens.
prefixReactNode—An element to appear at the start of the title.
suffixReactNode—An element to appear at the end of the title.
titlestring | ComponentClass<{}, any> | FunctionComponent<{}>—An element to appear as the title of the submenu.

Testkit

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

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.332.0 (2026-10-05) — 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.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.318.0 (2026-08-28) — maintenance release, no component-specific changes
  • 1.317.1 (2026-08-26) — maintenance release, no component-specific changes
  • 1.313.1 (2026-08-18) — maintenance release, no component-specific changes
  • 1.311.0 (2026-08-12) — maintenance release, no component-specific changes
  • 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.299.0 (2026-07-17) — 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.266.0 (2026-04-07) — 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.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.165.0 (2025-02-27) — fix: increase height of the container (#14562)
  • 1.144.0 (2024-12-03) — maintenance release, no component-specific changes
  • 1.143.0 (2024-11-25) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.131.0 (2024-10-10) — fix: restore selected submenu hover state (#14206)
  • 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.104.1 (2024-05-14) — maintenance release, no component-specific changes
  • 1.101.0 (2024-04-12) — maintenance release, no component-specific changes
  • 1.98.0 (2024-03-15) — maintenance release, no component-specific changes
  • 1.95.1 (2024-02-19) — fix: collapsed sidebar - selected state color is wrong (#13250)
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 22 October 2026

Did this help?