> ## 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

> Tooltips are typically used for explaining icons, Buttons, links, or actions that might not be immediately obvious. Tooltips are presented inside a container that is displayed when a user hovers or focuses on an element.

## Tooltip

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-tooltip--docs)

### 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](/aura-design-system/primitives/alert)—not a [Tooltip](/aura-design-system/primitives/tooltip).
* Critical or frequently needed information: surface it in the layout or [Dialog](/aura-design-system/primitives/dialog), not only in a tooltip.
* Redundant text: don’t mirror the visible [Button](/aura-design-system/primitives/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](/aura-design-system/primitives/button), [Toggle group](/aura-design-system/primitives/toggle-group) segments, compact [Toolbar](/aura-design-system/primitives/toolbar) items—always with an accessible name on the trigger, not only the tooltip.