Tag

Components/Form/Tag

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

Overview

Copy

A tag is a label used to categorize content or display an active selection that will be applied to a product or service.

Do

  • Use it to label, categorize or organize content using descriptive keywords
  • Use it to visualize selected values

Don't

  • Don't use it to display a number of items. Use <CounterBadge/> instead.
  • Don't use it to indicate status of an item. Use <Badge/> instead.

Feature examples

Size

Adjust the component size using `size` prop. It supports 4 sizes:
 - `large`
 - `medium`
 - `small`
 - `tiny`

Copy

Skin

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

Copy

Disabled

Disable all interactions with `disabled` prop. Use it to highlight inactive values or values that can't be removed.

Copy

Thumbnail

Give more context about the tag with a thumbnail placed in front of the text. It usually contains <Image/>, <Box/>, icon or <Avatar/>.

Copy

Remove Button

Control whether a tag can be removed or not with `removable` prop.

Copy

Max Width

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.

Copy

Common use case examples

Content Categorization

Use tags to visualize assigned categories or labels to a product. Usually applied via multi select dropdowns or popovers.

Copy

Code

Copy

Props

NameTypeDefaultDescription
children (required)ReactNode—Sets the text of the tag.
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
disabledboolean—Specifies whether the tag should be disabled.
ellipsisPropsEllipsisCommonProps—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.
maxWidthstring | 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.
removablebooleantrueSpecifies 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.
thumbReactElement—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.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
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—
existsChecks whether the component found with the given data hook.
elementGets 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.332.0 (2026-10-05) — maintenance release, no component-specific changes
  • 1.331.0 (2026-10-01) — 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.327.0 (2026-09-21) — feat: add a type prop (solid, outlined, transparent) that works with every skin; solid is the default and keeps the current look. (#17056) — has visual 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.296.0 (2026-07-08) — maintenance release, no component-specific changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.284.0 (2026-06-04) — maintenance release, no component-specific changes
  • 1.278.0 (2026-05-08) — maintenance release, no component-specific changes
  • 1.273.0 (2026-04-30) — maintenance release, no component-specific changes
  • 1.272.0 (2026-04-27) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — breaking: disabled state tokenization fix (#15983)
  • 1.254.0 (2026-02-03) — maintenance release, no component-specific changes
  • 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.244.0 (2026-01-02) — maintenance release, no component-specific changes
  • 1.228.0 (2025-11-18) — maintenance release, no component-specific changes
  • 1.213.0 (2025-08-19) — breaking: add tokens (#15204)
  • 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.203.0 (2025-07-01) — maintenance release, no component-specific changes
  • 1.196.0 (2025-06-04) — feat: deprecate theme prop (#14938)
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.129.1 (2024-10-01) — maintenance release, no component-specific changes
  • 1.107.0 (2024-05-29) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — 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?