Components/Feedback/Badge
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/badgeselectitem
An option builder for the <DropdownLayout/> component and its consumers.
<BadgeSelect/> or other dropdown lists.<ListItemSelect/> instead.Additional information, like user email or address can be inserted to subtitle area.
Component has a suffix area. If plain text or icon is inserted, component automatically inverts the color when selected.
The component supports 2 text sizes - medium (default) and small.
By default component wraps the text. If needed it can be configured to show ellipsis and display full value on hover.
All properties work together and can be combined in various ways. It can be rendered as standalone or as part of dropdown.
| 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 |
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. |
Import the driver matching your test environment:
| 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. |
Last updated: 22 October 2026