Components/Feedback/Badge
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/badgeselect
The BadgeSelect component is used for selecting a badge from a list.
<Badge/> instead.<Dropdown/> instead.This component can be used in controlled or uncontrolled modes. This ia an example of usage in controlled mode.
The BadgeSelect component has two different sizes: "small" and "medium" (default). This size is used to define the <Badge/> size.
The BadgeSelect has 3 different types: "solid" (default), "outlined", "transparent". This type is used to define the <Badge/> type.
The BadgeSelect can display a subtitle per option. This is an example of options with subtitles.
| 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. |
Import the driver matching your test environment:
| 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. |
Last updated: 22 October 2026