Skip to content
Material Design 2
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Material System

Introduction

Material studies

About our Material studies

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Material Foundation

Environment

Surfaces

Elevation

Light and shadows

Layout

Understanding layout

Pixel density

Responsive layout grid

Spacing methods

Component behavior

Applying density

Navigation

Understanding navigation

Navigation transitions

Search

Color

The color system

Applying color to UI

Color usage

Text legibility

Dark theme

Typography

The type system

Understanding typography

Language support

Sound

About sound

Applying sound to UI

Sound attributes

Sound choreography

Iconography

Product icons

System icons

Animated icons

Shape

About shape

Shape and hierarchy

Shape as expression

Shape and motion

Applying shape to UI

Motion

Understanding motion

The motion system

Speed

Choreography

Customization

Interaction

Gestures

Selection

States

Communication

Confirmation & acknowledgement

Data formats

Data visualization

Empty states

Help & feedback

Imagery

Launch screen

Onboarding

Offline states

Writing

Machine learning

Machine learning patterns

Object detection: live camera

Object detection: static image

Barcode Scanning

Material Guidelines

Material Theming

Overview

Implementing your theme

Usability

Accessibility

Bidirectionality

Platform guidance

Android bars

Android fingerprint

Android haptics

Android icons

Android navigating between apps

Android notifications

Android permissions

Android slices

Android split-screen

Android swipe-to-refresh

Android text selection toolbar

Android widget

Cross-platform adaptation

Components

App bars: bottom

App bars: top

Backdrop

Banners

Bottom navigation

Buttons

Buttons: floating action button

Cards

Checkboxes

Chips

Data tables

Date pickers

Dialogs

Dividers

Image lists

Lists

Menus

Navigation drawer

Navigation rail

Progress indicators

Radio buttons

Sheets: bottom

Sheets: side

Sliders

Snackbars

Switches

Tabs

Text fields

Time pickers

Tooltips

On this page

Tooltips ​

Tooltips display informative text when users hover over, focus on, or tap an element.

Tooltips hero image

Usage ​

When activated, tooltips display a text label identifying an element, such as a description of its function.

Principles ​


Tooltip principle: transient

Transient

Tooltips appear on hover, focus, or touch, and disappear after a short duration.

Tooltip principle: paired

Paired

Tooltips are always paired nearby the element with which they are associated.

Tooltip principle: succinct

Succinct

Tooltips only include short, descriptive text.

Placement ​

Use tooltips for interactive imagery

Do

Use tooltips for interactive imagery.

200% zoom
1. On hover
2. On focus

Don't use tooltips to restate visible UI text

Don't

Don't use tooltips to restate visible UI text.

200% zoom
1. On hover
2. On focus

Tooltips describe differences between similar elements

Do

200% zoom

1. Tooltips describe differences between similar elements
2. Tooltips distinguish actions with related iconography

Placement: don't display shadows on tooltips

Don't

200% zoom

1. Don't display shadows on tooltips
2. Don't display rich information and imagery on tooltips

Do: keep the position of the tooltip visible

Do

Keep the position of the tooltip visible.
Don't crop tooltips

Don't

Don't crop tooltips.

Desktop ​


Desktop tooltip on hover
Desktop tooltip on hover

Mobile ​


Tooltip displayed through long press
Tooltip summoned through focus (Android only)

Behavior ​

A tooltip is displayed upon tapping and holding a screen element or component (on mobile) or hovering over it (desktop). Continuously display the tooltip as long as the user long-presses or hovers over the element.

Timing ​

Display the tooltip for 1.5 seconds. If the user takes another action before that time ends, the tooltip will disappear.

Transitions ​

Tooltips use a fade transition pattern to enter and exit the screen.

1. 200%
2. 100%

On desktop, tooltips appear in the center of click targets and stay in place while cursor moves within the target.

1. Tooltip disappears when cursor moves out of the touch target
2. Tooltip remains while cursor moves within the touch target

Fade

A pattern for UI elements that enter or exit within the bounds of the screen

Related article

Theming ​

Reply Material Theme ​

This email app's tooltips have been customized using Material Theming. Areas of customization include color, typography, and shape.

Reply's customized tooltip
Reply's customized tooltip.

Reply

Reply is an email app that uses Material Design components and Material Theming to create an on-brand communication experience.

Related article

Color ​

Reply's tooltips use custom color on two elements: the container, and text string.

Reply Material theme: color
ElementCategoryAttributeValue
ContainerOn SurfaceColor
Opacity
#232F34
100%
Text stringSurfaceColor
Opacity
#FFFFFF
100%

The color system

Create a color theme that reflects your brand or style

Related article

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Typography ​

Reply's tooltips use custom typography for the text string.

Reply Material theme: typography
ElementCategoryAttributeValue
Text stringCaptionTypeface
Font
Size
Case
Work Sans
Regular
12
Sentence case

Understanding typography

Typography is critical in establishing hierarchy and expressing brand presence that supports an effective digital experience.

Related article

Shape ​

Reply's tooltips use a custom container shape, with a 50% corner radius.

Reply Material theme: shape
ElementCategoryAttributeValue
ContainerSmall componentFamily
Size
Rounded
50%

About shape

Direct attention, identify components, communicate state, and express brand

Related link

Specs ​

Desktop ​


C8824

Mobile ​


321616C
Pager
Previous pageTime pickers

Released under the Apache-2.0

Copyright © 2018-Present Google

https://m2.material.io/components/tooltips

Released under the Apache-2.0

Copyright © 2018-Present Google