# Tooltip

A tooltip is a small, noninteractive popup that provides brief supplementary text for an element on hover or keyboard focus.

- Type: artifact
- Domain: Experience & interface
- Level: Foundational
- Last reviewed: 2026-09-24
- Original: [Soroush’s Product Wiki](<https://wiki.soroush.uk/topic/tooltip/>)

## What it means

A tooltip supplies concise descriptive information about a control or element without becoming a destination for focus. It is supplementary: the interface should remain understandable and operable without discovering it. Interactive floating content is a popover or another pattern, not a tooltip.

## Why it matters

Tooltips can clarify unfamiliar icon controls without permanently adding visual text. Because hover is unavailable to many users and transient content is difficult to perceive, disciplined use prevents important instructions from becoming hidden.

## When to use it

Use a tooltip for a short label or explanation that supplements an already operable element, especially an unfamiliar icon. Use visible text for essential labels and instructions, and use a popover or dialog when content needs links, buttons, rich structure, or deliberate interaction.

## How it works

1. Write a brief supplement that does not duplicate a clear visible label.
2. Reveal it on both pointer hover and keyboard focus after a predictable delay.
3. Associate it programmatically with its trigger without moving focus into the tooltip.
4. Keep it visible while the pointer can move over it and allow Escape to dismiss it.
5. Test touch alternatives, zoom, viewport edges, magnification, and screen readers.

## A practical example

A formatting toolbar uses an unfamiliar icon for clearing styles. Keyboard focus or pointer hover reveals “Clear formatting,” while the button’s accessible name already exposes the same action. The tooltip can be dismissed without changing focus.

## Where it breaks

Tooltips are hard to discover on touch devices, can obscure nearby content, and are difficult for users with low vision or limited pointer control. They cannot substitute for visible instructions, error messages, or accessible names.

## Common mistakes

- Putting essential instructions only in hover content.
- Including buttons or links inside a tooltip.
- Showing tooltips on hover but not keyboard focus.
- Using a tooltip as the only accessible name for an icon control.

## Sources

1. [Tooltip Pattern](<https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/>) — W3C Web Accessibility Initiative · Technical guidance
2. [Understanding Success Criterion 1.4.13: Content on Hover or Focus](<https://www.w3.org/WAI/WCAG22/Understanding/content-on-hover-or-focus.html>) — W3C Web Accessibility Initiative · Standards guidance

## Related topics

- [Popover](<https://wiki.soroush.uk/topic/popover/>)
- [Accessible Name](<https://wiki.soroush.uk/topic/accessible-name/>)
- [Progressive Disclosure](<https://wiki.soroush.uk/topic/progressive-disclosure/>)
