BadgeSelectItem

Components/Feedback/Badge

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

Overview

Copy

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.

Copy

Suffix

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

Copy

Sizes

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

Copy

Text cropping

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

Copy

Advanced Example

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

Copy

Code

Copy

Props

NameTypeDefaultDescription
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
disabledboolean—If true, the item is disabled.
ellipsisboolean—Should the text and subtitle get ellipsis with tooltip, or should it get broken into lines when it reaches the end of its container.
highlightedboolean—If true, the item is highlighted.
idstring | number—Applied as data-hook HTML attribute that can be used in the tests.
selectedboolean—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 story for the full list of available skins.
subtitlestring—The secondary text to be rendered within the badge.
suffixReactNode—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:

Copy

Driver methods

MethodDescription
getText—
getSubtitleText—
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.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

Last updated: 22 October 2026

Did this help?