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 througharia-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
Name
Type
Default
Description
children *ReactNodenoneElement the tooltip is anchored to. Strings are wrapped in `BaseText`.
description *stringnoneDescription/body of the popover. Unlike the tooltip, it is multiline and
required — it is the reason the `Popover` exists beyond the tooltip.
iconReactNodenoneIcon displayed to the left of the title.
interactivebooleannoneLegacy no-op — kept only for API compatibility.
In `vendors/TippyHeadless` this prop enabled Tippy's "interactive" mode.
With `vendors/FloatingUI`, the floating tooltip is already inherently
interactive (hover/focus over the tooltip itself does not trigger
dismiss). Can be removed once consumers are cleaned up.
@deprecated
invertedbooleannoneInverts the color scheme (light background with dark text). Useful on
already-dark surfaces.
motion"fade""scale""slide-up""slide-down""slide-left""slide-right""collapse""sheet""sheet-top""drawer-left""drawer-right""push-left""push-right""none"'scale'Enter/exit animation of the bubble. The default
`scale` grows the bubble out of the anchor side on open
(`@starting-style`) and fades it back out on close — the bubble stays
mounted until the exit finishes (`useExitTransition`).
`prefers-reduced-motion` zeroes it centrally. Set `motion="none"` for an
instant show/hide. Same prop and vocabulary as `Dropdown`.
noArrowbooleannoneHides the arrow pointing at the anchored element.
onDismiss(() => void)noneCalled when the user clicks outside the tooltip. Required with `visible`.
titlestringnoneTitle displayed prominently at the top of the popover.
visiblebooleannoneControlled visibility. When set, `onDismiss` is required (the component
throws if it is missing).