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

## Article: BadgeSelectItem Component

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

## Article Content:

# BadgeSelectItem

_Components/Feedback/Badge_

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

## Overview

```jsx
() => {
  return (
    <Layout cols={1}>
      <BadgeSelectItem text="General skin - default" skin="general" />
      <BadgeSelectItem text="Standard skin" skin="standard" />
      <BadgeSelectItem text="Success skin" skin="success" />
    </Layout>
  );
};
```

An option builder for the `<DropdownLayout/>` component and its consumers.

### Do

- Use it to build status options for `<BadgeSelect/>` or other dropdown lists.
- Use the subtitle for extra details about an option, such as an email or address.

### Don't

- Don't use it for options that don't represent a status. Use `<ListItemSelect/>` instead.

### Feature examples

#### Subtitle

Additional information, like user email or address can be inserted to subtitle area.

```jsx
() => {
  return (
    <BadgeSelectItem
      text="Badge Select Item"
      subtitle="subtitle"
      skin="general"
    />
  );
};
```

#### Suffix

Component has a suffix area. If plain text or icon is inserted, component automatically inverts the color when selected.

```jsx
() => {
  return (
    <BadgeSelectItem
      text="BadgeSelectItem with suffix"
      suffix="suffix"
      skin="general"
    />
  );
};
```

#### Sizes

The component supports 2 text sizes - medium (default) and small.

```jsx
() => {
  return (
    <Layout cols={1}>
      <BadgeSelectItem
        text="Medium size - default"
        size="medium"
        skin="general"
      />
      <BadgeSelectItem text="Small size" size="small" skin="general" />
    </Layout>
  );
};
```

#### Text cropping

By default component wraps the text. If needed it can be configured to show ellipsis and display full value on hover.

```jsx
() => {
  return (
    <Layout cols={1}>
      <BadgeSelectItem
        text="This is a very very very very long text that is perfect to demonstrate how it will wrap at some point"
        subtitle="This is a very very very very long subtitle that is perfect to demonstrate how it will wrap into multiple lines  at some point"
        skin="general"
      />
      <BadgeSelectItem
        ellipsis
        text="This is a very very very very long text that is perfect to demonstrate how it will cropped by ellipsis at some point"
        subtitle="This is a very very very very long text that is perfect to demonstrate how it will cropped by ellipsis at some point"
        skin="general"
      />
    </Layout>
  );
};
```

#### Advanced Example

All properties work together and can be combined in various ways. It can be rendered as standalone or as part of dropdown.

```jsx
() => {
  return (
    <DropdownLayout
      visible
      inContainer
      selectedId={2}
      options={[
        badgeSelectItemBuilder({
          id: 0,
          text: 'Not Paid',
          subtitle: 'Waiting for a payment',
          skin: 'danger',
        }),
        badgeSelectItemBuilder({
          id: 1,
          text: 'Paid in Person',
          subtitle: 'Cash',
          skin: 'success',
          disabled: true,
        }),
        badgeSelectItemBuilder({
          id: 2,
          text: 'Paid Plan: Gold',
          subtitle: '8/10 sessions left • Valid until Jan 24 2021',
          skin: 'general',
        }),
        badgeSelectItemBuilder({
          id: 3,
          text: 'Paid Plan: Silver',
          subtitle: '10/10 sessions left • Valid until Dec 22 2020',
          skin: 'warning',
        }),
      ]}
    />
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `disabled` | `boolean` | — | If true, the item is disabled. |
| `ellipsis` | `boolean` | — | Should the text and subtitle get ellipsis with tooltip, or should it get broken into lines when it reaches the end of its container. |
| `highlighted` | `boolean` | — | If true, the item is highlighted. |
| `id` | `string \| number` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `selected` | `boolean` | — | If true, the item is selected. |
| `size` | `"small" \| "medium"` | — | Changing text size. |
| `skin` *(required)* | `"warning" \| "standard" \| "neutral" \| "premium" \| "success" \| "general" \| "danger" \| "neutralLight" \| "warningLight" \| "urgent" \| "neutralStandard" \| "neutralSuccess" \| "neutralDanger"` | — | The badge's skin. See the <Badge/> story for the full list of available skins. |
| `subtitle` | `string` | — | The secondary text to be rendered within the badge. |
| `suffix` | `ReactNode` | — | Accepts any content to render after the text, styled as secondary text. |
| `text` *(required)* | `ReactNode` | — | The text to be rendered within the badge. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getText` | — |
| `getSubtitleText` | — |
| `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.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.330.0** (2026-09-28) — 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.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.267.0** (2026-04-09) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.265.0** (2026-04-02) — 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.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