Components

Tooltip

Tooltips provide additional, nonessential information on hover or focus to provide clarity to the user.

Overview

Tooltips provide additional, nonessential information on hover or focus to provide clarity to the user. A tooltip is triggered by a UI element such as a button to provide more information to a user.

Tooltip component used with a social share button component

When to Use

Tooltips should be used sparingly and succinctly and with a specific purpose. Use to provide more context or explanation, such as defining a term or inline item.

Do not use tooltips for information for a user to complete their task, and do not use interactive elements within a tooltip.

Formatting

Anatomy

Tooltip anatomy diagram
  1. Interactive trigger button
  2. Tooltip container
  3. Body copy

Content

Main Elements

Interactive Trigger Button

A tooltip is controlled by a trigger button. An interactive element must trigger the tooltip to open on hover or focus. This interactive element is a button by function but can visually change its shape and size depending on the use case. The icon button is a common example of a tooltip trigger button.

Example of tooltip component with tooltip text
Alignment

The tooltip is positioned by default in the center. The tooltip can also be positioned dynamically to keep the container from bleeding off the page or covering important information.

Alignment of tooltip description on the left, center, and right of the icon

Placement

There should be 4px of padding between the trigger button and the tooltip and 4px of spacing in all orientations. The tooltip is positioned below the trigger button by default, but can be set to be placed to the left, right, or top as well. Do not cover related content that is essential to the user’s tasks. Tooltips should not bleed off page or behind other content.

Placement of tooltip description on the top, left, bottom, and right side of the icon