Components/Navigation/Verticaltabs
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/verticaltabs
Vertical tabs let users vertically navigate between different content sections within a page, card, or panel.
- Use it to organize multiple content sections within the same context.
- Use short and descriptive tab titles.
- Don't use it to show the path users need to follow to complete a process. Use
<Stepper/> instead.
- Don't place critical navigation elements within tabs.
- Don't make the user click back and forth on the different tabs to complete a single task.
Control the tab size with the size prop:
medium (default) is the standard used in common cases.
small fits into smaller elements and compact designs.
tiny is used for dense layouts.
skin controls the overall visual style of the VerticalTabs container and items.
standard (default)
light
neutral
Group related tabs together under a title by using a <VerticalTabs.TabsGroup/> wrapper.
Specify which tab is currently selected with the activeTabId prop.
Place tabs inside a </CustomModalLayout> to create a sidebar with structured content.
| Name | Type | Default | Description |
|---|
activeTabId | TabId | — | Current selected tab id. |
children | ReactNode | — | Child nodes of this component must be of type <VerticalTabs.TabsGroup> or <VerticalTabs.Footer> |
dataHook | string | — | Data attribute for testing purposes. |
ellipsis | boolean | — | Makes all text items into ellipsis when overflowing. |
maxWidth | string | — | Container max width. |
onChange | (id: TabId) => void | — | Callback function called on tab selection change with the following parameters(id) |
size | "small" | "tiny" | "medium" | — | Text Size (tiny, small, medium) |
skin | "standard" | "light" | "neutral" | — | Specifies the skin of a TabItem. |
Import the driver matching your test environment:
| Method | Description |
|---|
getActiveTabId | — |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
- 1.340.0 (2026-10-21) — breaking: in Harmony (odeditor), items have no background at rest or when disabled; hover and selected backgrounds are unchanged. (#17548) — has visual 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.328.0 (2026-09-22) — maintenance release, no component-specific changes
- 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
- 1.320.0 (2026-09-03) — maintenance release, no component-specific changes
- 1.310.0 (2026-08-10) — 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) — fix: action items wrapper added for padding (#16217) — has visual changes
- 1.269.0 (2026-04-15) — fix: word-break changed to break-word, not break-all (#16145) — has visual changes
- 1.267.0 (2026-04-09) — feat: maxwidth and ellipsis props (#16124) — has visual 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.254.0 (2026-02-03) — maintenance release, no component-specific changes
- 1.213.0 (2025-08-19) — maintenance release, no component-specific changes
- 1.169.0 (2025-03-10) — maintenance release, no component-specific changes
- 1.158.0 (2025-02-04) — maintenance release, no component-specific changes
- 1.139.0 (2024-11-07) — feat: neutral and premium skins (#14260)
- 1.133.0 (2024-10-14) — maintenance release, no component-specific changes
- 1.131.0 (2024-10-10) — maintenance release, no component-specific changes
- 1.130.0 (2024-10-02) — feat: introduce id and activeId suport as string (#14192)
- 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
- 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
- 1.93.0 (2024-02-08) — maintenance release, no component-specific changes
- 1.92.1 (2024-02-05) — maintenance release, no component-specific changes