CardFolderTabs

Components/Layout/CardFolderTabs

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

Overview

Copy

Card folder tabs allow users to organize content by a certain criteria in a card layout.

Do

  • Use it to distribute content within a card.
  • Use it to group card content by a specific criteria, such as status or type.

Don't

  • Don't use it to distribute content of a page. Use <Tabs/> instead.

Feature examples

Structure

This component is composed of a <CardFolderTabs> wrapper that holds any number of <CardFolderTabs.Tab/> items inside of it. You can specify content for each tab separately.

Copy

Tab button width

Specify maximum allowed tab width in pixels or percentage with `maxTabWidth` prop. Stretch tabs equally to fill the full width of a card with `fluid` prop.

Initially all tab buttons are sized to be equal with a maximum width of 138px. Set `maxTabWidth` value to "fit-content" to size them to match title width.

Copy

Disabled

Restrict users from opening a certain tab with `disabled` prop.

Copy

Custom title

Customize the tab title by overriding default text string value of `name` prop to any required components or their composition.

Copy

Text overflow

Control text overflow with `ellipsis` prop. By default, tab titles that exceed `maxTabWidth` will be truncated and displayed in a tooltip when the user hover over a tab. Set `ellipsis` to false to enable text wrapping.

Copy

Common use case examples

Empty state

Use section <EmptyState/> as tab content when there's no data to display.

Copy

Code

Copy

Props

NameTypeDefaultDescription
activeId (required)string—Specifies an id of a currently visible tab.
childrenReactNode—Sets the tabs of the card, as CardFolderTabs.Tab elements.
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
ellipsisbooleantrueSpecifies whether text that exceeds tab width is truncated with ellipsis. If false, text wraps to another line. Has no effect when mobile is enabled on <WixDesignSystemProvider/>, where labels never truncate or wrap.
fluidbooleanfalseStretches tabs to fill a 100% of a parent container width.
maxTabWidthstring | number | string & {}'138px'Defines a maximum width of a tab button. Ignored when mobile is enabled on <WixDesignSystemProvider/>, where tabs keep their full width and the row scrolls horizontally.
onTabChange(newActiveId: string) => void—Defines a callback function which is called on tab change. An id of a newly selected tab is passed as a parameter.
size"small" | "medium"'medium'Controls tab label font size.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
isTabDisabledByIdChecks whether tab is disabled by id
selectTabByIdSelects tab by tab by id
getSizeReturn tab text size
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.343.0 (2026-10-26) — feat: on mobile (WixDesignSystemProvider with mobile) the tab row scrolls horizontally instead of squeezing labels. Tabs keep their full label width, selecting a tab scrolls it to the start of the row with the previous tab peeking, and a fade marks the edges that still hide tabs. The scroll is smooth, or instant when the user prefers reduced motion. Desktop is unchanged. (#17333) — has visual changes
  • 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.3 (2026-09-29) — 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.323.0 (2026-09-10) — 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.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.258.0 (2026-02-23) — breaking: tokenization (#15938)
  • 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.165.0 (2025-02-27) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.93.1 (2024-02-12) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 30 October 2026

Did this help?