VerticalTabsItem

Components/Navigation/Verticaltabs

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

Overview

Copy

A vertical tabs item is a single row of content in <VerticalTabs/>.

Do

  • Use this as a part of the <VerticalTabs/> component.

Don't

  • Don't use a vertical tabs item as a stand-alone component.

Feature examples

Types

Use the type prop to change the behavior of the tab item:

  • tab can be used to organize settings into logical categories.
  • action can be used as a button.
  • title can be used to maintain structure between tab elements.
Copy

Affix

Add more context to actions with affix icons:

  • Emphasize the tab action with a prefixIcon.
  • Indicate that the tab will open a popover or navigate users to another page with a suffixIcon.
Copy

Disabled

Use the disabled prop to indicate that a tab can't be selected.

Copy

Skin

To specify the look of the item, use skin property:

  • premium- for the premium skin
Copy

Code

Copy

Props

NameTypeDefaultDescription
aria-controlsstring—Used for connecting tab panel to the tab item.
childrenReactNode—Children - only single child is allowed here.
classNamestring—
dataHookstring—Data attribute for testing purposes.
disabledboolean—Specifies whether the item is disabled.
idstring | number—Identifier to help identify the current selected tab.
onBlur(event: FocusEvent, triggers: Triggers) => void—
onFocus(event: FocusEvent, triggers: Triggers) => void—
prefixIconReactElement—Prefix Icon - should be Icon
refRefObject—
skin"premium"—Specifies the look of the item.
suffixIconReactElement—Suffix Icon - should be Icon or IconButton with the size="tiny" prop
tabIndexnumber—Controls focus relative order.
type"title" | "action" | "tab"—Type of vertical tab item. can be of the following: 'tab' (default), 'action', 'title'

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
isDisabledCheck if tab is disabled
isSelectedCheck if tab is selected
getTextGet the item's text
pressEnterKeyKeydown with Enter key
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

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.330.0 (2026-09-28) — maintenance release, no component-specific changes
  • 1.329.0 (2026-09-24) — 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.311.0 (2026-08-12) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — 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.272.0 (2026-04-27) — maintenance release, no component-specific changes
  • 1.267.0 (2026-04-09) — 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.254.0 (2026-02-03) — 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.213.0 (2025-08-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.158.0 (2025-02-04) — maintenance release, no component-specific changes
  • 1.139.1 (2024-11-07) — fix: fixing runtime error of not returning null (#14271)
  • 1.139.0 (2024-11-07) — maintenance release, no component-specific changes
  • 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) — maintenance release, no component-specific changes
  • 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

Last updated: 22 October 2026

Did this help?