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

## Article: CardFolderTabs Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/layout/card-folder-tabs-component.md

## Article Content:

# CardFolderTabs

_Components/Layout/CardFolderTabs_

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

## Overview

```jsx
() => {
  const [activeTabId, setActiveTabId] = React.useState('1');
  const [selectedWebsitePlanId, setSelectedWebsitePlanId] = React.useState(1);
  const [selectedBusinessPlanId, setSelectedBusinessPlanId] = React.useState(0);

  return (
    <StorybookComponents.Stack flexDirection="column" width="50%">
      <CardFolderTabs
        maxTabWidth="auto"
        activeId={activeTabId}
        onTabChange={(tabId) => setActiveTabId(tabId)}
      >
        <CardFolderTabs.Tab id="1" name="Website Plans">
          <Card>
            <Card.Content>
              <Layout cols={1} gap="18px">
                <Radio
                  checked={selectedWebsitePlanId === 0}
                  onChange={() => setSelectedWebsitePlanId(0)}
                  label={
                    <Cell>
                      <Box
                        width="100%"
                        align="space-between"
                        verticalAlign="middle"
                      >
                        <Box direction="vertical">
                          <Box verticalAlign="middle" gap="9px">
                            <Heading size="small">VIP</Heading>
                          </Box>
                          <Text size="small" secondary>
                            First Priority Support
                          </Text>
                        </Box>
                        <Heading size="small">
                          $24,50 <Text size="small"> /month</Text>
                        </Heading>
                      </Box>
                    </Cell>
                  }
                />
                <Divider />
                <Radio
                  checked={selectedWebsitePlanId === 1}
                  onChange={() => setSelectedWebsitePlanId(1)}
                  label={
                    <Cell>
                      <Box
                        width="100%"
                        align="space-between"
                        verticalAlign="middle"
                      >
                        <Box direction="vertical">
                          <Box verticalAlign="middle" gap="9px">
                            <Heading size="small">Unlimited</Heading>
                            <Badge size="small" skin="premium" type="outlined">
                              Most popular
                            </Badge>
                          </Box>
                          <Text size="small" secondary>
                            Entrepreneurs & Freelancers
                          </Text>
                        </Box>
                        <Heading size="small">
                          $12,50 <Text size="small"> /month</Text>
                        </Heading>
                      </Box>
                    </Cell>
                  }
                />
                <Divider />
                <Radio
                  checked={selectedWebsitePlanId === 2}
                  onChange={() => setSelectedWebsitePlanId(2)}
                  label={
                    <Cell>
                      <Box
                        width="100%"
                        align="space-between"
                        verticalAlign="middle"
                      >
                        <Box direction="vertical">
                          <Box verticalAlign="middle" gap="9px">
                            <Heading size="small">Combo</Heading>
                          </Box>
                          <Text size="small" secondary>
                            For Personal Use
                          </Text>
                        </Box>
                        <Heading size="small">
                          $8,50 <Text size="small"> /month</Text>
                        </Heading>
                      </Box>
                    </Cell>
                  }
                />
                <Divider />
                <Radio
                  checked={selectedWebsitePlanId === 3}
                  onChange={() => setSelectedWebsitePlanId(3)}
                  label={
                    <Cell>
                      <Box
                        width="100%"
                        align="space-between"
                        verticalAlign="middle"
                      >
                        <Box direction="vertical">
                          <Box verticalAlign="middle" gap="9px">
                            <Heading size="small">Connect Domain</Heading>
                          </Box>
                          <Text size="small" secondary>
                            Most Basic
                          </Text>
                        </Box>
                        <Heading size="small">
                          $4,50 <Text size="small"> /month</Text>
                        </Heading>
                      </Box>
                    </Cell>
                  }
                />
                <Divider />
                <TextButton suffixIcon={<Icons.ExternalLink />}>
                  See all plan features
                </TextButton>
              </Layout>
            </Card.Content>
          </Card>
        </CardFolderTabs.Tab>
        <CardFolderTabs.Tab id="2" name="Business Plans">
          <Card>
            <Card.Content>
              <Layout cols={1} gap="18px">
                <Radio
                  checked={selectedBusinessPlanId === 0}
                  onChange={() => setSelectedBusinessPlanId(0)}
                  label={
                    <Cell>
                      <Box
                        width="100%"
                        align="space-between"
                        verticalAlign="middle"
                      >
                        <Box direction="vertical">
                          <Box verticalAlign="middle" gap="9px">
                            <Heading size="small">Business VIP</Heading>
                          </Box>
                          <Text size="small" secondary>
                            Get the Full Suite
                          </Text>
                        </Box>
                        <Heading size="small">
                          $35 <Text size="small"> /month</Text>
                        </Heading>
                      </Box>
                    </Cell>
                  }
                />
                <Divider />
                <Radio
                  checked={selectedBusinessPlanId === 1}
                  onChange={() => setSelectedBusinessPlanId(1)}
                  label={
                    <Cell>
                      <Box
                        width="100%"
                        align="space-between"
                        verticalAlign="middle"
                      >
                        <Box direction="vertical">
                          <Box verticalAlign="middle" gap="9px">
                            <Heading size="small">Business Unlimited</Heading>
                            <Badge size="small" skin="premium" type="outlined">
                              Most popular
                            </Badge>
                          </Box>
                          <Text size="small" secondary>
                            Grow Your Business
                          </Text>
                        </Box>
                        <Heading size="small">
                          $25 <Text size="small"> /month</Text>
                        </Heading>
                      </Box>
                    </Cell>
                  }
                />
                <Divider />
                <Radio
                  checked={selectedBusinessPlanId === 2}
                  onChange={() => setSelectedBusinessPlanId(2)}
                  label={
                    <Cell>
                      <Box
                        width="100%"
                        align="space-between"
                        verticalAlign="middle"
                      >
                        <Box direction="vertical">
                          <Box verticalAlign="middle" gap="9px">
                            <Heading size="small">Business Basic</Heading>
                          </Box>
                          <Text size="small" secondary>
                            Accept Online Payments
                          </Text>
                        </Box>
                        <Heading size="small">
                          $17 <Text size="small"> /month</Text>
                        </Heading>
                      </Box>
                    </Cell>
                  }
                />
                <Divider />
                <TextButton suffixIcon={<Icons.ExternalLink />}>
                  See all plan features
                </TextButton>
              </Layout>
            </Card.Content>
          </Card>
        </CardFolderTabs.Tab>
      </CardFolderTabs>
    </StorybookComponents.Stack>
  );
};
```

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.

```jsx
() => {
  const [activeTabId, setActiveTabId] = React.useState('1');

  return (
    <CardFolderTabs
      activeId={activeTabId}
      onTabChange={(tabId) => setActiveTabId(tabId)}
    >
      <CardFolderTabs.Tab name="Tab 1" id="1">
        <Card.Content>
          <StorybookComponents.Placeholder height="180px">
            First tab content
          </StorybookComponents.Placeholder>
        </Card.Content>
      </CardFolderTabs.Tab>
      <CardFolderTabs.Tab name="Tab 2" id="2">
        <Card.Content>
          <StorybookComponents.Placeholder height="180px">
            Second tab content
          </StorybookComponents.Placeholder>
        </Card.Content>
      </CardFolderTabs.Tab>
      <CardFolderTabs.Tab name="Tab 3" id="3">
        <Card.Content>
          <StorybookComponents.Placeholder height="180px">
            Third tab content
          </StorybookComponents.Placeholder>
        </Card.Content>
      </CardFolderTabs.Tab>
    </CardFolderTabs>
  );
};
```

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

```jsx
() => {
  const renderCardTab = ({ name, id }) => (
    <CardFolderTabs.Tab name={name} id={id}>
      <Card.Content>
        <StorybookComponents.Placeholder height="180px" />
      </Card.Content>
    </CardFolderTabs.Tab>
  );

  return (
    <StorybookComponents.Stack flexDirection="column">
      <CardFolderTabs activeId={'1'} maxTabWidth="120px">
        {renderCardTab({ name: 'Tab 1', id: '1' })}
        {renderCardTab({ name: 'Tab 2', id: '2' })}
        {renderCardTab({ name: 'Tab 3', id: '3' })}
      </CardFolderTabs>
      <CardFolderTabs activeId={'1'} fluid>
        {renderCardTab({ name: 'Tab 1', id: '1' })}
        {renderCardTab({ name: 'Tab 2', id: '2' })}
        {renderCardTab({ name: 'Tab 3', id: '3' })}
      </CardFolderTabs>
      <CardFolderTabs activeId={'1'} maxTabWidth="fit-content">
        {renderCardTab({ name: 'Short Title', id: '1' })}
        {renderCardTab({ name: 'Short Title', id: '2' })}
        {renderCardTab({ name: 'Long Title Stretches Tab Width', id: '3' })}
      </CardFolderTabs>
    </StorybookComponents.Stack>
  );
};
```

#### Disabled

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

```jsx
<CardFolderTabs activeId={'1'}>
  <CardFolderTabs.Tab name="Tab 1" id="1">
    <Card.Content>
      <StorybookComponents.Placeholder height="180px" />
    </Card.Content>
  </CardFolderTabs.Tab>
  <CardFolderTabs.Tab name="Disabled" id="3" disabled>
    <Card.Content>
      <StorybookComponents.Placeholder height="180px" />
    </Card.Content>
  </CardFolderTabs.Tab>
</CardFolderTabs>;
```

#### Custom title

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

```jsx
<CardFolderTabs activeId={'1'} maxTabWidth="180px">
  <CardFolderTabs.Tab
    name={
      <StorybookComponents.Stack gap="6px">
        <Icons.Inbox />
        <Text>Tab Title 1</Text>
      </StorybookComponents.Stack>
    }
    id="1"
  >
    <Card.Content>
      <StorybookComponents.Placeholder height="180px" />
    </Card.Content>
  </CardFolderTabs.Tab>
  <CardFolderTabs.Tab
    name={
      <StorybookComponents.Stack gap="6px">
        <Icons.Notification />
        <Text>Tab Title 2</Text>
      </StorybookComponents.Stack>
    }
    id="2"
  >
    <Card.Content>
      <StorybookComponents.Placeholder height="180px" />
    </Card.Content>
  </CardFolderTabs.Tab>
</CardFolderTabs>;
```

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

```jsx
() => {
  const renderCardTab = ({ name, id }) => (
    <CardFolderTabs.Tab name={name} id={id}>
      <Card.Content>
        <StorybookComponents.Placeholder height="180px" />
      </Card.Content>
    </CardFolderTabs.Tab>
  );

  return (
    <StorybookComponents.Stack flexDirection="column">
      <CardFolderTabs activeId={'1'} maxTabWidth="138px">
        {renderCardTab({ name: 'Hover over to see the full title', id: '1' })}
        {renderCardTab({ name: 'Hover over to see the full title', id: '2' })}
      </CardFolderTabs>

      <CardFolderTabs activeId={'1'} maxTabWidth="138px" ellipsis={false}>
        {renderCardTab({ name: 'Multiline Tab Title', id: '1' })}
        {renderCardTab({ name: 'Multiline Tab Title', id: '2' })}
      </CardFolderTabs>
    </StorybookComponents.Stack>
  );
};
```

### Common use case examples

#### Empty state

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

```jsx
() => {
  const [activeTabId, setActiveTabId] = React.useState('1');

  return (
    <CardFolderTabs
      activeId={activeTabId}
      onTabChange={(tabId) => setActiveTabId(tabId)}
    >
      <CardFolderTabs.Tab name="All" id="1">
        <Card.Content>
          <EmptyState
            title="No reservations"
            subtitle="You’ll see all your online reservations here."
            skin="section"
          >
            <TextButton prefixIcon={<Icons.Add />}>New reservation</TextButton>
          </EmptyState>
        </Card.Content>
      </CardFolderTabs.Tab>
      <CardFolderTabs.Tab name="Open" id="2">
        <Card.Content>
          <EmptyState
            title="No open reservations"
            subtitle="There are no pending reservations that need your attention."
            skin="section"
          >
            <TextButton prefixIcon={<Icons.Add />}>New reservation</TextButton>
          </EmptyState>
        </Card.Content>
      </CardFolderTabs.Tab>
      <CardFolderTabs.Tab name="Upcoming" id="3">
        <Card.Content>
          <EmptyState
            title="No upcoming reservations"
            subtitle="There are no reservations for the next 24 hours."
            skin="section"
          >
            <TextButton prefixIcon={<Icons.Add />}>New reservation</TextButton>
          </EmptyState>
        </Card.Content>
      </CardFolderTabs.Tab>
    </CardFolderTabs>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `activeId` *(required)* | `string` | — | Specifies an id of a currently visible tab. |
| `children` | `ReactNode` | — | Sets the tabs of the card, as `CardFolderTabs.Tab` elements. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `ellipsis` | `boolean` | `true` | Specifies 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. |
| `fluid` | `boolean` | `false` | Stretches tabs to fill a 100% of a parent container width. |
| `maxTabWidth` | `string \| 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:

```jsx
// UniDriver
import { CardFolderTabsUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { CardFolderTabsTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { CardFolderTabsTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { CardFolderTabsTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `isTabDisabledById` | Checks whether tab is disabled by id |
| `selectTabById` | Selects tab by tab by id |
| `getSize` | Return tab text size |
| `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. |

## 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](invalid-url)) — 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](invalid-url))
- **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