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

## Article: BadgeSelect Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/feedback/badge-select/badge-select-component.md

## Article Content:

# BadgeSelect

_Components/Feedback/Badge_

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

## Overview

```jsx
() => {
  return (
    <BadgeSelect
      options={[
        { id: '0', skin: 'general', text: 'general' },
        { id: '1', skin: 'standard', text: 'standard' },
        { id: '2', skin: 'danger', text: 'danger' },
        { id: '3', skin: 'success', text: 'success' },
        { id: '4', skin: 'neutral', text: 'neutral' },
        { id: '5', skin: 'neutralLight', text: 'neutralLight' },
        { id: '6', skin: 'warning', text: 'warning' },
        { id: '7', skin: 'warningLight', text: 'warningLight' },
        { id: '8', skin: 'urgent', text: 'urgent' },
        { id: '9', skin: 'neutralStandard', text: 'neutralStandard' },
        { id: '10', skin: 'neutralSuccess', text: 'neutralSuccess' },
        { id: '11', skin: 'neutralDanger', text: 'neutralDanger' },
        { id: '12', skin: 'premium', text: 'premium' },
      ]}
    />
  );
};
```

The BadgeSelect component is used for selecting a badge from a list.

### Do

- Use it to let users change the status of an item where the status is shown.
- Keep the text of each option short, one or two words.

### Don't

- Don't use it for a status that users can't change. Use `<Badge/>` instead.
- Don't use it for options that don't represent a status. Use `<Dropdown/>` instead.

### Feature examples

#### Controlled example

This component can be used in controlled or uncontrolled modes. This ia an example of usage in controlled mode.

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

  return (
    <BadgeSelect
      options={[
        {
          id: '0',
          skin: 'general',
          text: 'general',
        },
        {
          id: '1',
          skin: 'standard',
          text: 'standard',
        },
        {
          id: '2',
          skin: 'danger',
          text: 'danger',
        },
        {
          id: '3',
          skin: 'success',
          text: 'success',
        },
      ]}
      selectedId={selectedId}
      onSelect={(selectedOption) => setSelectedId(String(selectedOption.id))}
    />
  );
};
```

#### Sizes

The BadgeSelect component has two different sizes: "small" and "medium" (default). This size is used to define the `<Badge/>` size.

```jsx
() => {
  return (
    <Layout>
      <Cell>
        <BadgeSelect
          size="small"
          options={[
            { id: '0', skin: 'success', text: 'success' },
            { id: '1', skin: 'warning', text: 'warning' },
          ]}
        />
      </Cell>
      <Cell>
        <BadgeSelect
          size="medium"
          options={[
            { id: '0', skin: 'success', text: 'success' },
            { id: '1', skin: 'warning', text: 'warning' },
          ]}
        />
      </Cell>
    </Layout>
  );
};
```

#### Type

The BadgeSelect has 3 different types: "solid" (default), "outlined", "transparent". This type is used to define the `<Badge/>` type.

```jsx
() => {
  return (
    <Layout>
      <Cell>
        <BadgeSelect
          type="solid"
          options={[
            { id: '0', skin: 'warning', text: 'warning' },
            { id: '1', skin: 'success', text: 'success' },
          ]}
        />
      </Cell>
      <Cell>
        <BadgeSelect
          type="outlined"
          options={[
            { id: '0', skin: 'warning', text: 'warning' },
            { id: '1', skin: 'success', text: 'success' },
          ]}
        />
      </Cell>
      <Cell>
        <BadgeSelect
          type="transparent"
          options={[
            { id: '0', skin: 'warning', text: 'warning' },
            { id: '1', skin: 'success', text: 'success' },
          ]}
        />
      </Cell>
    </Layout>
  );
};
```

#### Subtitle

The BadgeSelect can display a subtitle per option. This is an example of options with subtitles.

```jsx
() => {
  return (
    <Layout>
      <Cell>
        <BadgeSelect
          options={[
            { id: '0', skin: 'general', text: 'general', subtitle: 'subtitle' },
            { id: '1', skin: 'standard', text: 'standard' },
          ]}
        />
      </Cell>
      <Cell>
        <BadgeSelect
          options={[
            {
              id: '0',
              skin: 'general',
              text: 'general',
              subtitle: 'this is a very long subtitle',
            },
            { id: '1', skin: 'standard', text: 'standard' },
          ]}
        />
      </Cell>
    </Layout>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used to create driver in testing. |
| `onSelect` | `(option: BadgeSelectItemProps) => void` | — | Callback function called whenever the user selects a different option in the list. |
| `options` *(required)* | `BadgeSelectItemProps[]` | — | An array of options. Each option must have a unique `id`, a `text` and a `skin` whose value should match one of `<Badge/>`'s skin values. |
| `popoverProps` | `PopoverCommonProps` | — | Accepts common popover props that are passed to the dropdown popover. |
| `ref` | `null \| string \| (instance: BadgeSelectImperativeActions \| null) => void \| RefObject<BadgeSelectImperativeActions>` | — | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). |
| `selectedId` | `string` | — | The id of the selected option in the list. |
| `showDrawerOnMobile` | `boolean` | `true` | Specifies whether the options open in a bottom `<Drawer/>` when `WixDesignSystemProvider` has `mobile` enabled. |
| `size` | `"small" \| "tiny" \| "medium"` | `'medium'` | The size of the `<Badge/>` |
| `type` | `"transparent" \| "solid" \| "outlined"` | `'solid'` | The type of the `<Badge/>` |
| `uppercase` | `boolean` | `true` | Whether the text of the `<Badge/>` should be uppercase. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `exists` | — |
| `clickAtOption` | Clicks an option at given index |
| `text` | Gets badge text |
| `getType` | Gets badge type |
| `getSkin` | Gets badge skin |
| `getSize` | Gets badge size |
| `isUppercase` | Checks whether the text is uppercase |
| `hasClickCursor` | Checks whether badge is clickable |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns 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.331.0** (2026-10-01) — 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.316.0** (2026-08-25) — 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.279.0** (2026-05-13) — maintenance release, no component-specific changes
- **1.278.0** (2026-05-08) — maintenance release, no component-specific changes
- **1.272.0** (2026-04-27) — maintenance release, no component-specific changes
- **1.270.0** (2026-04-20) — 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.242.0** (2025-12-19) — maintenance release, no component-specific changes
- **1.149.1** (2024-12-20) — maintenance release, no component-specific changes
- **1.116.0** (2024-07-22) — 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