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

## Article: TableToolbar Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/lists/table/table-toolbar-component.md

## Article Content:

# TableToolbar

_Components/Lists/Table_

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

## Overview

```jsx
() => {
  const [selectedId, setSelectedId] = React.useState('0');

  return (
    <Card>
      <Table columns={[]}>
        <TableToolbar>
          <TableToolbar.ItemGroup position="start">
            <TableToolbar.Item>
              <TableToolbar.Title>Products</TableToolbar.Title>
            </TableToolbar.Item>
          </TableToolbar.ItemGroup>
          <TableToolbar.ItemGroup position="end">
            <TableToolbar.Item>
              <FormField label="Filter by" labelPlacement="left">
                <Dropdown
                  options={[
                    { id: '0', value: 'All Statuses' },
                    { id: '1', value: 'In Stock' },
                    { id: '2', value: 'Out Of Stock' },
                  ]}
                  selectedId={selectedId}
                  onSelect={(option) => setSelectedId(String(option.id))}
                  size="small"
                  border="round"
                  popoverProps={{ appendTo: 'window' }}
                />
              </FormField>
            </TableToolbar.Item>
            <TableToolbar.Item>
              <Search size="small" />
            </TableToolbar.Item>
          </TableToolbar.ItemGroup>
        </TableToolbar>
      </Table>
    </Card>
  );
};
```

Table toolbars allow users to organize their table title, filters, and actions into 2 containers: left and right.

### Do

- Use it to display the title of the table.
- Use it to display and organize filters.
- Use it to display and organize bulk actions.

### Don't

- Don't use it to display the applied filters list. Use `<Table.Subtoolbar/>` instead.

### Feature examples

#### Structure

Toolbars consist of 2 empty `<TableToolbar.ItemGroup/>` containers.

To add content like filter dropdowns or search inputs use the `<TableToolbar.Item/>` wrapper. The required margins will automatically be applied.

```jsx
<Card>
  <TableToolbar>
    <TableToolbar.ItemGroup>
      <TableToolbar.Item>
        <StorybookComponents.Placeholder>
          Left aligned content
        </StorybookComponents.Placeholder>
      </TableToolbar.Item>
    </TableToolbar.ItemGroup>
    <TableToolbar.ItemGroup>
      <TableToolbar.Item>
        <StorybookComponents.Placeholder>
          Right aligned content
        </StorybookComponents.Placeholder>
      </TableToolbar.Item>
    </TableToolbar.ItemGroup>
  </TableToolbar>
</Card>;
```

#### Title

Add titles to describe the table content using `<TableToolbar.Title/>`.

```jsx
<Card>
  <TableToolbar>
    <TableToolbar.ItemGroup>
      <TableToolbar.Item>
        <TableToolbar.Title>Title</TableToolbar.Title>
      </TableToolbar.Item>
    </TableToolbar.ItemGroup>
  </TableToolbar>
</Card>;
```

#### Label

Use `<TableToolbar.Label/>` to add a text label for filter options or a count of existing items.

```jsx
<Card>
  <TableToolbar>
    <TableToolbar.ItemGroup>
      <TableToolbar.Item>
        <TableToolbar.Label>12 products</TableToolbar.Label>
      </TableToolbar.Item>
    </TableToolbar.ItemGroup>
  </TableToolbar>
</Card>;
```

#### Main toolbar

The main toolbar appears above each table. It consists of descriptive info and optional data filters which can be easily edited to fit the user's goals.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Title>Title</TableToolbar.Title>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Title>Title</TableToolbar.Title>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Title>Title</TableToolbar.Title>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Title>Title</TableToolbar.Title>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Title>Title</TableToolbar.Title>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Button
            priority="secondary"
            prefixIcon={<Icons.ContentFilterSmall />}
            size="small"
          >
            Filter
          </Button>
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Label>3 items</TableToolbar.Label>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Label>3 items</TableToolbar.Label>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Label>3 items</TableToolbar.Label>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Label>3 items</TableToolbar.Label>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <TableToolbar.Label>3 items</TableToolbar.Label>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Button
            priority="secondary"
            prefixIcon={<Icons.ContentFilterSmall />}
            size="small"
          >
            Filter
          </Button>
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Dropdown
            size="small"
            border="round"
            selectedId={0}
            options={[
              { id: 0, value: 'All options' },
              { id: 1, value: 'Option 1' },
              { id: 2, value: 'Option 2' },
              { id: 3, value: 'Option 3' },
            ]}
          />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <FormField labelPlacement="left" label="Label">
            <Dropdown
              size="small"
              border="round"
              selectedId={0}
              options={[
                { id: 0, value: 'All options' },
                { id: 1, value: 'Option 1' },
                { id: 2, value: 'Option 2' },
                { id: 3, value: 'Option 3' },
              ]}
            />
          </FormField>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <FormField labelPlacement="left" label="Label">
            <Dropdown
              size="small"
              border="round"
              selectedId={0}
              options={[
                { id: 0, value: 'All options' },
                { id: 1, value: 'Option 1' },
                { id: 2, value: 'Option 2' },
                { id: 3, value: 'Option 3' },
              ]}
            />
          </FormField>
        </TableToolbar.Item>
        <TableToolbar.Item>
          <FormField labelPlacement="left" label="Label">
            <Dropdown
              size="small"
              border="round"
              selectedId={0}
              options={[
                { id: 0, value: 'All options' },
                { id: 1, value: 'Option 1' },
                { id: 2, value: 'Option 2' },
                { id: 3, value: 'Option 3' },
              ]}
            />
          </FormField>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
      <TableToolbar.ItemGroup>
        <TableToolbar.Item>
          <Search size="small" />
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
</StorybookComponents.Stack>;
```

#### Actions toolbar

The actions toolbar only appears in tables with an enabled item selection. It replaces the main toolbar when at least one item is selected.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup position="start">
        <TableToolbar.Item>
          <Text size="small" weight="normal">
            3 selected
          </Text>
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Box height="18px">
            <Divider direction="vertical" />
          </Box>
        </TableToolbar.Item>
        <TableToolbar.Item layout="button">
          <Button
            skin="inverted"
            size="small"
            prefixIcon={<Icons.UploadExportSmall />}
          >
            Export
          </Button>
        </TableToolbar.Item>
        <TableToolbar.Item layout="button">
          <Button
            skin="inverted"
            size="small"
            prefixIcon={<Icons.DuplicateSmall />}
          >
            Duplicate
          </Button>
        </TableToolbar.Item>
        <TableToolbar.Item layout="button">
          <PopoverMenu
            triggerElement={
              <Button
                skin="inverted"
                size="small"
                suffixIcon={<Icons.ChevronDownSmall />}
              >
                More Actions
              </Button>
            }
          >
            <PopoverMenu.MenuItem
              prefixIcon={<Icons.Discount />}
              text="Add discount"
            />
            <PopoverMenu.MenuItem
              prefixIcon={<Icons.Collections />}
              text="Add to collection"
            />
            <PopoverMenu.MenuItem prefixIcon={<Icons.Delete />} text="Delete" />
          </PopoverMenu>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
  <Card>
    <TableToolbar>
      <TableToolbar.ItemGroup position="start">
        <TableToolbar.Item>
          <Box gap="12px">
            <Box gap="3px">
              <Text size="small" weight="bold">
                3
              </Text>
              <Text size="small">out of 96 selected</Text>
            </Box>
            <TextButton size="small" weight="normal">
              Select All
            </TextButton>
          </Box>
        </TableToolbar.Item>
        <TableToolbar.Item>
          <Box height="18px">
            <Divider direction="vertical" />
          </Box>
        </TableToolbar.Item>
        <TableToolbar.Item layout="button">
          <Button
            skin="inverted"
            size="small"
            prefixIcon={<Icons.UploadExportSmall />}
          >
            Export
          </Button>
        </TableToolbar.Item>
        <TableToolbar.Item layout="button">
          <Button
            skin="inverted"
            size="small"
            prefixIcon={<Icons.DuplicateSmall />}
          >
            Duplicate
          </Button>
        </TableToolbar.Item>
        <TableToolbar.Item layout="button">
          <PopoverMenu
            triggerElement={
              <Button
                skin="inverted"
                size="small"
                suffixIcon={<Icons.ChevronDownSmall />}
              >
                More Actions
              </Button>
            }
          >
            <PopoverMenu.MenuItem
              prefixIcon={<Icons.Discount />}
              text="Add discount"
            />
            <PopoverMenu.MenuItem
              prefixIcon={<Icons.Collections />}
              text="Add to collection"
            />
            <PopoverMenu.MenuItem prefixIcon={<Icons.Delete />} text="Delete" />
          </PopoverMenu>
        </TableToolbar.Item>
      </TableToolbar.ItemGroup>
    </TableToolbar>
  </Card>
</StorybookComponents.Stack>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `ReactNode` | — | Accepts the toolbar content, usually `<TableToolbar.ItemGroup/>` elements. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute to be used in the tests. |
| `removeVerticalPadding` | `boolean` | — | Removes vertical paddings from the component. |

## Testkit

No testkit for this component — it doesn't expose a unidriver testkit.

## 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.335.0** (2026-10-12) — maintenance release, no component-specific changes
- **1.330.3** (2026-09-29) — fix: when `WixDesignSystemProvider` has `mobile` enabled, toolbar items that don't fit now scroll sideways in a single row instead of being squeezed, and swiping the toolbar no longer moves the page. Desktop behavior is unchanged. ([#17267](invalid-url)) — has visual changes
- **1.330.0** (2026-09-28) — 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.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.307.0** (2026-08-03) — 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.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — 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