Skip to the content

Popover

Popover is a Tooltip with a structured body: an optional icon, a title and a multiline description (required). It inherits the whole Tooltip API — triggers, position, controlled mode, motion and stacking.
Overlays

When to use

Use when
  • A feature in a dense interface needs a short explanation with a heading.
  • The hint needs more than one line.
Avoid when
  • One word or phrase is enough — use Tooltip.
  • The user must act before continuing — use Modal.
  • You report the result of an action — use Notification.

Usage

<Popover
  title="Upload files"
  description="Drop files here or pick them from your device."
  icon={<Icon icon={upload} />}
>
  <IconButton label="Upload help" icon={<Icon icon={playCircle} />} />
</Popover>

inverted switches to the raised surface for dark backgrounds. The body is capped at 400px wide.

Stacking

Like the Tooltip, the popover paints on theme.zIndex.tooltip (default 10000), above modals and toasts. Inside a Modal or Sheet it renders inside that overlay. See Tooltip → Stacking for theme overrides.

Accessibility

  • The bubble has role="tooltip" and describes the anchor through aria-describedby.
  • It opens on hover and on keyboard focus, so the anchor must be focusable and carry its own name.
  • Keep interactive controls out of the body; a Popover is a hint, not a dialog.

Properties

See also