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

## Article: SidebarItemNext Component

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

## Article Content:

# SidebarItemNext

_Components/Navigation/Sidebar_

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

## Overview

```jsx
<Box height="55px">
  <SidebarNext selectedKey="1" isLoading={false}>
    <SidebarItemNext itemKey="1">Home</SidebarItemNext>
  </SidebarNext>
</Box>;
```

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.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SidebarItemNext suffix={<CounterBadge>1</CounterBadge>}>
    Label
  </SidebarItemNext>
  <SidebarItemNext suffix={<Badge skin="warning">New</Badge>}>
    Label
  </SidebarItemNext>
</StorybookComponents.Stack>;
```

#### 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.

```jsx
<StorybookComponents.Stack>
  <Box direction="vertical" gap="6px">
    <Text size="tiny" secondary>
      Expanded
    </Text>
    <Box width="220px" direction="vertical">
      <SidebarItemNext prefix={<Icons.Dashboard />}>Dashboard</SidebarItemNext>
      <SidebarItemNext prefix={<Icons.Settings />}>Settings</SidebarItemNext>
    </Box>
  </Box>
  <Box direction="vertical" gap="6px">
    <Text size="tiny" secondary>
      Minimized
    </Text>
    <Box width="48px" direction="vertical">
      <SidebarItemNext
        minimized
        prefix={<Icons.Dashboard />}
        minimizedTooltipContent="Dashboard"
      >
        Dashboard
      </SidebarItemNext>
      <SidebarItemNext
        minimized
        prefix={<Icons.Settings />}
        minimizedTooltipContent="Settings"
      >
        Settings
      </SidebarItemNext>
    </Box>
  </Box>
</StorybookComponents.Stack>;
```

#### Disabled

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

```jsx
<SidebarItemNext disabled>Disabled</SidebarItemNext>;
```

### 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.

```jsx
<SidebarItemNext as="a" href="https://www.wix.com">
  Wix.com homepage
</SidebarItemNext>;
```

#### Setup selection with sidebar

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

Truncate children item's text with `isInQuickNavigation` prop.

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

  return (
    <Box height="200px">
      <SidebarNext isLoading={false} selectedKey={selectedKey}>
        <SidebarSubMenuNext
          title="Parent item"
          itemKey="1"
          onClick={() => setSelectedKey('1-1')}
        >
          <SidebarItemNext
            itemKey="1-1"
            onClick={() => {
              setSelectedKey('1-1');
            }}
          >
            Child item that's setup incorrectly, it allows text wrapping{' '}
          </SidebarItemNext>
          <SidebarItemNext
            itemKey="1-2"
            onClick={() => setSelectedKey('1-2')}
            isInQuickNavigation
          >
            Child item using isInQuickNavigation property preveting from text
            being wrapped
          </SidebarItemNext>
        </SidebarSubMenuNext>
      </SidebarNext>
    </Box>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `as` | `"button"` | `'button'` | Renders the item as another HTML tag or component. |
| `children` | `ReactNode` | — | Sets the item's label. |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `disabled` | `boolean` | — | Indicates whether to display the item as disabled. |
| `itemKey` | `string` | — | 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. |
| `minimized` | `boolean` | — | 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. |
| `minimizedTooltipContent` | `ReactNode` | — | Content of the tooltip shown when the sidebar is minimized. |
| `onClick` | `MouseEventHandler` | — | A callback to be triggered on click. |
| `onMouseEnter` | `MouseEventHandler` | — | A callback to be triggered on mouse enter. |
| `onMouseLeave` | `MouseEventHandler` | — | A callback to be triggered on mouse leave. |
| `prefix` | `ReactNode` | — | An element to appear at the start of the text. |
| `role` | `string` | — | 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. |
| `suffix` | `ReactNode` | — | 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](invalid-url))
- **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](invalid-url))
- **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](invalid-url)) — has visual changes
- **1.299.0** (2026-07-17) — breaking: rounded, narrower items for Harmony theme ([#16562](invalid-url)) — 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](invalid-url))
- **1.153.0** (2025-01-13) — feat: add on mouse functions. ([#14429](invalid-url))
- **1.152.0** (2025-01-10) — feat: exporting getSuffixCount ([#14443](invalid-url))
- **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](invalid-url))
- **1.119.0** (2024-07-31) — fix: padding-left ([#13988](invalid-url))
- **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](invalid-url))
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes