Tooltip Edit

Tooltip is a React component to render floating help text relative to a node when it receives focus or when the user places the mouse cursor atop it. If the tooltip exceeds the bounds of the page in the direction it opens, its position will be flipped automatically.

Accessibility note: the tooltip text is hidden from screen readers and assistive technologies that understand ARIA. To make it accessible, use an aria-label attribute on the same element the tooltip is applied to, preferably using the same text used for the tooltip.


Render a Tooltip, passing as a child the element to which it should anchor:

import { Tooltip } from '@wordpress/components';

const MyTooltip = () => (
    <Tooltip text="More information">
        <div>Hover for more information</div>

Top ↑


The component accepts the following props:

Top ↑


The direction in which the tooltip should open relative to its parent node. Specify y- and x-axis as a space-separated string. Supports "top", "bottom" y axis, and "left", "center", "right" x axis.

  • Type: String
  • Required: No
  • Default: "top center"

Top ↑


The element to which the tooltip should anchor.

NOTE: You must pass only a single child. Tooltip renders itself as a clone of children with a Popover added as an additional child.

  • Type: Element
  • Required: Yes

Top ↑


The tooltip text to show on focus or hover.

  • Type: String
  • Required: No

Top ↑

shortcut (web only)

  • Type: string or object
  • Required: No

If shortcut is a string, it is expecting the display text. If shortcut is an object, it will accept the properties of display (string) and ariaLabel (string).

Top ↑

delay (web only)

Time in milliseconds to wait before showing tooltip after the tooltip’s visibility is toggled. This prop is currently only available for the web platforms.

  • Type: Number
  • Required: No
  • Default: 700

Top ↑

visible (native only)

Whether the tooltip should be displayed on initial render. This prop is currently only available for the native mobile app built with React Native.

  • Type: Boolean
  • Required: No
  • Default: false