Components/Form/Tag
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/tag
A tag is a label used to categorize content or display an active selection that will be applied to a product or service.
<CounterBadge/> instead.<Badge/> instead.Adjust the component size using `size` prop. It supports 4 sizes:
 - `large`
 - `medium`
 - `small`
 - `tiny`
Control the skin of a component with `skin` prop. Is support 8 skins:
 - `standard` - use it to list selected/active values
 - `error` - use it to highlight an invalid value
 - `warning` - use it to highlight a value that can have an unexpected impact
 - `dark` - use it to show a value that represents a variable
 - `neutral` - use it when the tag needs minimal emphasis
 - `success` - use it to highlight confirmed values
 - `light` - use it on dark backgrounds
 - `lightOutlined` - use it on light backgrounds when the tag needs minimal emphasis
Disable all interactions with `disabled` prop. Use it to highlight inactive values or values that can't be removed.
Give more context about the tag with a thumbnail placed in front of the text. It usually contains <Image/>, <Box/>, icon or <Avatar/>.
Control whether a tag can be removed or not with `removable` prop.
Limit the width of a tag with `maxWidth` prop. Hover over labels that exceed the specified width to reveal the full text in a tooltip.
Use tags to visualize assigned categories or labels to a product. Usually applied via multi select dropdowns or popovers.
| Name | Type | Default | Description |
|---|---|---|---|
children (required) | ReactNode | — | Sets the text of the tag. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
disabled | boolean | — | Specifies whether the tag should be disabled. |
ellipsisProps | EllipsisCommonProps | — | Allows to pass common tooltip props to the tooltip that shows the full label when it's truncated. |
id (required) | string | — | Assigns an unique identifier for the tag. |
maxWidth | string | number | string & {} | — | Sets a maximum tag width. |
onClick | (id: string, event: MouseEvent<HTMLButtonElement, MouseEvent>) => void | — | Defines a callback function which is called whenever a tag component is clicked. It passes the id property as the first parameter and a mouse event as second parameter. |
onRemove | (id: string) => void | — | Defines a callback function which is called when removing the tag. It passes the id property as a parameter. |
removable | boolean | true | Specifies whether the tag is removable or not. If enabled, a small clickable X icon is displayed on the right side of a component. |
size | "small" | "tiny" | "medium" | "large" | — | Controls the size of the component. |
skin | "error" | "warning" | "standard" | "light" | "neutral" | "dark" | "success" | "lightOutlined" | — | Sets the skin of the component. |
theme | "error" | "warning" | "standard" | "light" | "neutral" | "dark" | "success" | "lightOutlined" | — | Sets the skin of the component. Used only when skin isn't set. |
thumb | ReactElement | — | Displays a thumbnail at the front of a tag label. Usually contain icons or <Avatar/>. |
type | "transparent" | "solid" | "outlined" | 'solid' | Controls the visual style of the tag: a filled background, an outline on a surface fill, or text only. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
isTiny | — |
isSmall | — |
isMedium | — |
isLarge | — |
isStandardTheme | — |
isWarningTheme | — |
isErrorTheme | — |
isDarkTheme | — |
isSuccessTheme | — |
isStandardSkin | — |
isWarningSkin | — |
isErrorSkin | — |
isDarkSkin | — |
isSuccessSkin | — |
isRemovable | — |
removeTag | — |
click | — |
isThumbExists | — |
isDisabled | — |
getLabel | — |
getCloseButtonSkin | — |
getCloseButtonTheme | — |
getCloseButtonSize | — |
getTextSize | — |
getTextWeight | — |
isClickable | — |
isHoverable | — |
pressKey | — |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
base | Returns UniDriver for the base element. |
type prop (solid, outlined, transparent) that works with every skin; solid is the default and keeps the current look. (#17056) — has visual changesLast updated: 22 October 2026