> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: FloatingHelper Component

## Article: FloatingHelper Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/overlays/floating-helper-component.md

## Article Content:

# FloatingHelper

_Components/Overlays/FloatingHelper_

Interactive docs page: <https://wix-pages.com/design-system-documentation/#/component/floatinghelper>

## Overview

```jsx
() => {
  return (
    <Box height="100px" verticalAlign="middle" paddingRight="10px">
      <FloatingHelper
        initiallyOpened={false}
        target={<Text>Hover to show the floating helper</Text>}
        content={
          <FloatingHelper.Content
            title="Don’t forget to setup payments"
            body="In order to sell your music you need to choose a payment method."
          />
        }
        placement="right"
      />
    </Box>
  );
};
```

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.

### Do

- Use it to introduce a new or updated feature next to the element it describes.
- Keep the title and body short, and add one action at most.
- Show one floating helper at a time.

### Don't

- Don't use it for information users need to complete a task. Use `<SectionHelper/>` instead.
- Don't use it to explain how a control works. Use `<Tooltip/>` or `<InfoIcon/>` instead.

### Feature examples

#### Full Example

A full example with an action button and an image.

```jsx
() => {
  return (
    <Box height="150px" verticalAlign="middle" paddingRight="10px">
      <FloatingHelper
        initiallyOpened={false}
        target={<Text>Hover to show the floating helper</Text>}
        content={
          <FloatingHelper.Content
            title="Don’t forget to setup payments"
            body="In order to sell your music you need to choose a payment method."
            actionText="Ok, Take Me There"
            onActionClick={() => null}
            image={<Icons.Image width="102" height="102" viewBox="4 4 18 18" />}
          />
        }
        placement="right"
      />
    </Box>
  );
};
```

#### Programmatic Open Example (Uncontrolled mode)

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.

```jsx
() => {
  const helperRef = React.useRef(null);

  return (
    <Box height="100px" verticalAlign="middle">
      <Button onClick={() => helperRef.current.open()}>Click to open</Button>
      <FloatingHelper
        ref={helperRef}
        initiallyOpened={false}
        target={<span />}
        content={
          <FloatingHelper.Content
            title="Don’t forget to setup payments"
            body="In order to sell your music you need to choose a payment method."
          />
        }
        placement="right"
      />
    </Box>
  );
};
```

#### Controlled Example

```jsx
() => {
  const [isHelperOpen, setOpenHelper] = React.useState(false);

  return (
    <Box height="100px" verticalAlign="middle">
      <Button onClick={() => setOpenHelper(!isHelperOpen)}>
        Click to {isHelperOpen ? 'Close' : 'Open'}
      </Button>
      <FloatingHelper
        opened={isHelperOpen}
        target={<span />}
        content={
          <FloatingHelper.Content
            title="Don’t forget to setup payments"
            body="In order to sell your music you need to choose a payment method."
          />
        }
        placement="right"
      />
    </Box>
  );
};
```

#### Skins

`<FloatingHelper/>` has two skins: \`dark\` (default) and \`light\`.

```jsx
() => {
  return (
    <Layout>
      <Cell>
        <Box height="150px" verticalAlign="middle">
          <FloatingHelper
            initiallyOpened={false}
            target={<Text>Hover to show the floating helper</Text>}
            content={
              <FloatingHelper.Content
                title="Don’t forget to setup payments"
                body="In order to sell your music you need to choose a payment method."
              />
            }
            placement="right"
          />
        </Box>
      </Cell>
      <Cell>
        <Box height="150px" verticalAlign="middle">
          <FloatingHelper
            skin="light"
            initiallyOpened={false}
            target={<Text>Hover to show the floating helper</Text>}
            content={
              <FloatingHelper.Content
                title="Don’t forget to setup payments"
                body="In order to sell your music you need to choose a payment method."
              />
            }
            placement="right"
          />
        </Box>
      </Cell>
    </Layout>
  );
};
```

## Code

```jsx
import { FloatingHelper } from '@wix/design-system';
```

### Props

| 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. |

## Testkit

No testkit for this component — it doesn't expose a unidriver testkit.

## Changelog

- **1.340.0** (2026-10-21) — maintenance release, no component-specific changes
- **1.339.0** (2026-10-19) — maintenance release, no component-specific changes
- **1.338.0** (2026-10-15) — maintenance release, no component-specific changes
- **1.332.0** (2026-10-05) — fix: `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](invalid-url))
- **1.331.0** (2026-10-01) — maintenance release, no component-specific changes
- **1.330.3** (2026-09-29) — maintenance release, no component-specific changes
- **1.329.0** (2026-09-24) — maintenance release, no component-specific changes
- **1.328.0** (2026-09-22) — maintenance release, no component-specific changes
- **1.327.0** (2026-09-21) — feat: add `whiteOutline`, `dark`, and `darkOutline` action button skins. ([#17097](invalid-url)) — has visual changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.308.0** (2026-08-04) — fix: respect the `width` prop when content is appended to the window ([#16726](invalid-url))
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.291.0** (2026-06-19) — maintenance release, no component-specific changes
- **1.288.0** (2026-06-15) — maintenance release, no component-specific changes
- **1.279.0** (2026-05-13) — maintenance release, no component-specific changes
- **1.278.0** (2026-05-08) — maintenance release, no component-specific changes
- **1.277.0** (2026-05-07) — fix: pass moveBy prop to Popover ([#16245](invalid-url))
- **1.275.0** (2026-05-04) — fix: fixed issue with appendTo prop ([#16219](invalid-url))
- **1.272.0** (2026-04-27) — fix: use correct open prop in ClosablePopover ([#16198](invalid-url))
- **1.271.0** (2026-04-22) — fix: moved closablepopover down ([#16182](invalid-url))
- **1.267.0** (2026-04-09) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.241.0** (2025-12-17) — maintenance release, no component-specific changes
- **1.220.0** (2025-09-29) — maintenance release, no component-specific changes
- **1.196.0** (2025-06-04) — maintenance release, no component-specific changes
- **1.195.0** (2025-06-03) — maintenance release, no component-specific changes
- **1.165.0** (2025-02-27) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.104.1** (2024-05-14) — maintenance release, no component-specific changes
- **1.93.0** (2024-02-08) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes