Skip to main content
Use Tag for categories, priorities, or other short attributes. Keep a text label so the meaning does not depend on color. Use Status when you need a state indicator and loading feedback.

Category label

color is required and accepts a theme color or transparent. The default element is a span. Add a decorative icon with startIcon; the label supplies its accessible meaning.

Variants

soft is the default treatment. solid emphasizes the label, outline adds a border, and ghost removes the background. Use borderStyle="dashed" with outline and weight="medium" for a stronger label.

Filter by a tag

Supplying onClick renders a button. Selection state belongs to your application; use aria-pressed for a toggle and a visible treatment for the selected state. disabled prevents pointer and keyboard activation. When render replaces an interactive tag with a non-button element, set nativeButton={false}.

Long labels

By default, constrained string labels truncate and expose their full text in a tooltip on hover. preventShrink keeps the full label width and turns off that tooltip, so make sure the surrounding layout can accommodate it. preventPadding removes the horizontal padding for custom layouts.

Props

Types and defaults are generated from the public component types. Native attributes and event handlers are also accepted.
"solid" | "dashed"
default:"solid"
Border style used by the outline variant.
"ruby" | "red" | "crimson" | "tomato" | "orange" | "amber" | "yellow" | "lime" | "grass" | "green" | "jade" | "mint" | "turquoise" | "cyan" | "sky" | "blue" | "iris" | "violet" | "purple" | "plum" | "pink" | "bronze" | "gold" | "brown" | "gray" | "transparent"
required
Theme color for the tag, or transparent for an unfilled label.
boolean
default:"false"
Applies disabled styling and prevents pointer and keyboard activation.
boolean
default:"true"
Set to false when a clickable tag uses render with an element other than a native button.
boolean
default:"false"
Removes the tag padding.
boolean
default:"false"
Keeps the tag from shrinking and disables string-label truncation and its tooltip.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Allows you to replace the component’s HTML element with a different tag, or compose it with another component.Accepts a ReactElement or a function that returns the element to render.
ReactNode
Decorative icon before the label. Hidden from assistive technology.
"solid" | "outline" | "soft" | "ghost"
default:"soft"
Visual treatment of the tag background and border.
"regular" | "medium"
default:"regular"
Font weight of the label.