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

SidebarItemNext

Components/Navigation/Sidebar

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

Overview

Copy

SidebarItemNext is a navigation action that reflects a single option in sidebar navigation list.

Do

  • Use it to build <SidebarNext/> navigation

Don't

  • Don't use it as a stand alone component

Feature examples

Suffix

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

Copy

Minimized

An item normally takes its minimized state from the parent sidebar. Set minimized to render the collapsed, icon-only form regardless. It is the escape hatch for an item rendered across a bundle boundary, where the sidebar context does not resolve.

The prop hides the label; the rail width still comes from the container, so place the item in a narrow one to get the collapsed look. Always pair it with minimizedTooltipContent, because once the label is hidden the tooltip is the only thing naming the item. An item with no prefix renders nothing at all when minimized.

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.

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

Code

Copy

Props

NameTypeDefaultDescription
as"button"'button'Renders the item as another HTML tag or component.
childrenReactNode—Sets the item's label.
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
disabledboolean—Indicates whether to display the item as disabled.
itemKeystring—Sets a unique key for the item. The item is marked as selected when it matches the selectedKey of <SidebarNext/>, and the key is passed to onClick as the second argument.
minimizedboolean—Renders the item in its collapsed form (icon only, with minimizedTooltipContent). Overrides the minimized state provided by the parent SidebarNext — needed when the item is rendered across a bundle boundary, where the context doesn't resolve.
minimizedTooltipContentReactNode—Content of the tooltip shown when the sidebar is minimized.
onClickMouseEventHandler—A callback to be triggered on click.
onMouseEnterMouseEventHandler—A callback to be triggered on mouse enter.
onMouseLeaveMouseEventHandler—A callback to be triggered on mouse leave.
prefixReactNode—An element to appear at the start of the text.
rolestring—Defines one of the aria roles to provide semantic meaning to content.
skin"light" | "neutral" | "dark"—The skin of the item. Overrides the skin provided by the parent SidebarNext.
suffixReactNode—An element/array of elements to appear at the end of the text. max number of elements to pass is 2.

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) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.323.0 (2026-09-10) — maintenance release, no component-specific changes
  • 1.319.0 (2026-08-31) — maintenance release, no component-specific changes
  • 1.318.0 (2026-08-28) — maintenance release, no component-specific changes
  • 1.317.1 (2026-08-26) — fix: in the Harmony (odeditor) theme the tooltip shown on minimized items now renders as the standard Harmony Tooltip (dark surface, white label) instead of inheriting the dark-skin sidebar tooltip colors. Other themes are unchanged. (#16892)
  • 1.317.1 (2026-08-26) — fix: suffix content (badges, status icons, action buttons) is now vertically centered on the item text instead of top-aligned when the suffix is taller than its siblings. (#16892)
  • 1.317.0 (2026-08-26) — maintenance release, no component-specific changes
  • 1.313.1 (2026-08-18) — 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.300.0 (2026-07-20) — feat: add skin prop that overrides context skin (#16572) — has visual changes
  • 1.299.0 (2026-07-17) — breaking: rounded, narrower items for Harmony theme (#16562) — has visual 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.273.0 (2026-04-30) — 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.246.0 (2026-01-09) — maintenance release, no component-specific changes
  • 1.242.0 (2025-12-19) — maintenance release, no component-specific changes
  • 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.211.0 (2025-08-07) — maintenance release, no component-specific changes
  • 1.169.0 (2025-03-10) — maintenance release, no component-specific changes
  • 1.165.0 (2025-02-27) — maintenance release, no component-specific changes
  • 1.160.1 (2025-02-07) — fix: exclude existing properties from HTMLAttributes (#14512)
  • 1.153.0 (2025-01-13) — feat: add on mouse functions. (#14429)
  • 1.152.0 (2025-01-10) — feat: exporting getSuffixCount (#14443)
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.131.0 (2024-10-10) — fix: fix color when using as anchor (#14200)
  • 1.119.0 (2024-07-31) — fix: padding-left (#13988)
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.103.3 (2024-04-30) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — 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.97.0 (2024-02-26) — maintenance release, no component-specific changes
  • 1.95.1 (2024-02-19) — fix: sidebar ui improvements (#13248)
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 21 October 2026

Did this help?