← Components/primitives

AiLabel

Carbon's AI surface marker. Used to indicate a UI region where AI assistance is active (suggestions, generated text, automated decisions). Renders a sparkle glyph on a tinted background.

primitivesstablea11y: untested2/3 coverageEdit on GitHub ↗
primitives-ailabel--defaultOpen all variants →

When to use

  • Mark a region of the UI where AI assistance is active or contributed to the rendered content.
  • Pair mode="button" with a `Slug` (variant="ai") popover that shows the AI's reasoning / source.
  • Use mode="inline" next to a piece of generated text to flag its provenance.

When not to use

  • Brand / promo callouts that aren't AI-specific → use `Badge` or `Tag`.
  • Long-form AI output presentation → use the chat-bubble pattern (planned) or Notification pattern.