artifactExperience & interface

Tooltip

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

Download Markdown (.md)

01What 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.[1][2]

02Why 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.

03When 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.

04How 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.

05A practical example

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.

06Where 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.

07Sources

  1. Tooltip PatternW3C Web Accessibility Initiative · Technical guidanceTooltip Pattern
  2. Understanding Success Criterion 1.4.13: Content on Hover or FocusW3C Web Accessibility Initiative · Standards guidanceUnderstanding Success Criterion 1.4.13: Content on Hover or Focus
View saved topics

Start typing to search titles, definitions, categories, and frameworks.