Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cognite.com/llms.txt

Use this file to discover all available pages before exploring further.

Tooltip

v1.0.0 | View in Storybook

When to use

  • Clarification: Use Tooltips when there’s a need to explain UI elements that may not be self-explanatory.
  • Icons Buttons: When controls use icons without labels, or the label needs more clarity, a Tooltip can provide context or detail.
  • Short instructions: Use Tooltips for brief instructions or details that would otherwise clutter the main interface if shown all the time.
  • Non-critical info: Tooltips are best used for supplementary or optional information that does not require immediate attention.

When to use something else

  • Long copy: use inline text, side panels, or Alert—not a Tooltip.
  • Critical or frequently needed information: surface it in the layout or Dialog, not only in a tooltip.
  • Redundant text: don’t mirror the visible Button label in the tooltip.

Behavior

  • On hover: The Tooltip should appear when the user hovers over or focuses on the trigger element and disappear when the hover/focus is removed.
  • On focus (accessibility): Tooltips should also activate when the user focuses on an element using the keyboard (e.g., pressing Tab to navigate between buttons). This ensures that screen reader users and keyboard-only users can interact with the Tooltips.
  • Delay: Introduce a slight delay before showing the Tooltip (e.g., 200ms-500ms).

Often used with

  • Icon-only Button, Toggle group segments, compact Toolbar items—always with an accessible name on the trigger, not only the tooltip.
Last modified on May 11, 2026