Components/Overlays/FloatingHelper
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/floatinghelper
Floating helper is a popover that points to an element on the page to introduce a new or updated feature. It can hold a title, body text, an image and an action, and users close it with its close button.
<SectionHelper/> instead.<Tooltip/> or <InfoIcon/> instead.A full example with an action button and an image.
In `Uncontrolled` mode, the default behavior is that the popover content is opened when mouse-enter is triggered on the target and closes when the close button is clicked. This option is not recommended but is still supported for backward compatibility.
<FloatingHelper/> has two skins: `dark` (default) and `light`.
| Name | Type | Default | Description |
|---|---|---|---|
appearance | "light" | "dark" | — | Controls the skin of the floating helper when skin isn't set. |
appendTo | null | Element | "window" | "scrollParent" | "viewport" | "parent" | Predicate | 'window' | Enables calculations in relation to a dom element. |
children | ReactNode | — | Sets the trigger and the content of the popover, as Popover.Element and Popover.Content elements. |
content (required) | ReactNode | — | A <FloatingHelper.Content> component. |
dataHook | string | — | Applied as data-hook HTML attribute that can be used in the tests. |
hideDelay | number | — | Set a delay on closing. |
initiallyOpened | boolean | true | Controls whether the popover's content is initially opened (In Uncontrolled mode only) |
moveBy | MoveByOffset | — | Moves the floating helper relative to the parent by x or y. |
onClose | () => void | — | Defines a callback function which is called when the popover content is requested to be closed. In controlled mode, it's called when the close button is clicked. In uncontrolled mode, it's called after the popover closes. |
onOpen | () => void | — | Callback to call when the popover content is requested to be opened (Uncontrolled mode only) |
opened | boolean | — | Controls whether the popover's content is shown or not (aka Controlled mode). When undefined, then the component is Uncontrolled. See open/close behaviour section in docs. |
placement (required) | "right" | "left" | "top" | "bottom" | "auto" | "auto-start" | "auto-end" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-end" | "bottom-start" | "left-end" | "left-start" | — | The location to display the content. |
skin | "light" | "dark" | — | Skin : dark or light |
target (required) | ReactNode | — | The target of the popover. |
width | string | number | '444px' | Width HTML attribute of the content. If a number is passed then it defaults to px. e.g width={400} => width="400px" |
zIndex | number | — | Floating helper z-index. |
No testkit for this component — it doesn't expose a unidriver testkit.
hideDelay now keeps the helper shown for the given number of milliseconds after it's closed. Previously the prop was ignored and the helper closed right away. (#17292)whiteOutline, dark, and darkOutline action button skins. (#17097) — has visual changeswidth prop when content is appended to the window (#16726)Last updated: 30 October 2026