Skip to content


The Tooltip component adds a tooltip to add context to elements on the page.

⚠️ Usage warning! ⚠️

Tooltips as a UI pattern should be our last resort for conveying information because it is hidden by default and often with zero or little visual indicator of its existence.

Before adding a tooltip, please consider: Is this information essential and necessary? Can the UI be made clearer? Can the information be shown on the page by default?

Attention: we use aria-label for tooltip contents, because it is crucial that they are accessible to screen reader users. However, aria-label replaces the text content of an element in screen readers, so only use Tooltip on elements with no existing text content, or consider using title for supplemental information.

Default example

Text with a tooltip

System props

System props are deprecated in all components except Box. Please use the sx prop instead.

Tooltip components get COMMON system props. Read our System Props doc page for a full list of available props.

Component props

alignStringCan be either left or right.
directionStringCan be one of n, ne, e, se, s, sw, w, nwSets where the tooltip renders in relation to the target.
noDelayBooleanWhen set to true, tooltip appears without any delay
aria-labelStringText used in aria-label (for accessibility).
wrapBooleanUse true to allow text within tooltip to wrap.
Edit this page on GitHub
2 contributorsVanAndersonemplums
Last edited by VanAnderson on July 22, 2021