> 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: FloatingNotification Component

## Article: FloatingNotification Component

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

## Article Content:

# FloatingNotification

_Components/Feedback_

> **Deprecated.** FloatingNotification is deprecated and will be removed in the next major version. Please use SectionHelper instead.

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

## Overview

```jsx
<Box direction="vertical" align="center">
  <FloatingNotification
    type="success"
    text='"Screenshot 2023-04-11.png" moved to trash.'
    textButtonProps={{ label: 'Undo' }}
  />
</Box>;
```

Notification informs users about the status change in application. Floating notification is used as a temporary overlay element or inline element within cards.

### Do

- Use it to provide contextual feedback on the outcome of user action.
- Use it to notify users about a happened change in the application.
- Display notifications inside modals as a temporary overlay.
- Place as a section message first in the section that it applies to.

### Don't

- Don't use it to display system-wide alerts. Use `<Notification/>` instead.
- Don't place an application level messages. Use `<SectionHelper/>` instead.

### Feature examples

#### Skin

Control the appearance of the floating notification with `type` prop. It supports 7 options:

- `standard` (default) - use it to provide additional information relevant to current user task or an action.
- `success` - use it to inform users about successful operation.
- `destructive` - use it for error messages and information about critical issues that prevent to continue.
- `warning` - use it to draw the user's attention to unresolved issues that might affect the application, but doesn't block the process.
- `premium` - use it for premium upgrades only — packages that let accept payments, connect domain and have business email. [Read more about Premium patterns](https://docs.google.com/document/d/1mALfPW9BOZgAjaFpvor5la3WGhGkXIxpbkF2GFrapU0/edit).
- `preview` - use it to present process status or related additional data.
- `dark` - use it to emphasize informational messages in the context of other content.

[Figma](https://www.figma.com/file/1G0njzZNT1gkFkllkEntpr/Wix-Style-Library?node-id=9385%3A446535&t=831U4NrdryUDoy6a-1)

```jsx
<StorybookComponents.Stack flexDirection="column">
  <FloatingNotification type="standard" text="Standard (default)" />
  <FloatingNotification type="success" text="Success" />
  <FloatingNotification type="warning" text="Warning" />
  <FloatingNotification type="destructive" text="Destructive" />
  <FloatingNotification type="premium" text="Premium" />
  <FloatingNotification type="preview" text="Preview" />
  <FloatingNotification type="dark" text="Dark" />
</StorybookComponents.Stack>;
```

#### Width

Control component width in pixels or percentage with `width` prop.

Set component to fill 100% of its parent container width with `fullWidth` prop. Prop has an effect on notification appearance - it removes left/right borders and corner radius, changes component height and paddings.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <FloatingNotification width="300px" text="Fixed width" />
  <FloatingNotification fullWidth text="Full width" />
</StorybookComponents.Stack>;
```

#### Actions

Add call to actions to a notification with:

- `buttonProps` - use to add a primary action
- `textButtonProps` - use it to add a text button. Add a link to an external URL with `href` prop.

Component can have both actions at the same time.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <FloatingNotification text="Text message" buttonProps={{ label: 'Action' }} />
  <FloatingNotification
    text="Text message"
    textButtonProps={{ label: 'Link' }}
  />
  <FloatingNotification
    text="Text message"
    buttonProps={{ label: 'Action' }}
    textButtonProps={{
      label: 'Link to wix.com',
      as: 'a',
      href: 'https://www.wix.com',
    }}
  />
</StorybookComponents.Stack>;
```

#### Close Button

Control whether notification can be dismissed by a user with `showCloseButton` prop.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <FloatingNotification text="Dismissable" />
  <FloatingNotification text="Non-dismissable" showCloseButton={false} />
</StorybookComponents.Stack>;
```

#### Prefix

Add more context for the notification purpose with `prefixIcon`.

```jsx
<FloatingNotification
  text="Notification message here"
  prefixIcon={<Icons.InfoCircle />}
/>;
```

### Common use case examples

#### In front of content

Position notification on top of content in modals to update users about the status change.

```jsx
() => {
  const [state, setState] = React.useState(true);
  return (
    <CustomModalLayout
      title="Account details"
      subtitle="Manage name and email details."
      secondaryButtonText="Cancel"
      primaryButtonText="Save"
      showHeaderDivider
      overflowY="visible"
      onCloseButtonClick={() => setState(true)}
      primaryButtonOnClick={() => setState(true)}
      secondaryButtonOnClick={() => setState(true)}
    >
      <Layout>
        {state && (
          <Box
            position="absolute"
            top="24px"
            left="50%"
            transform="translateX(-50%)"
          >
            <FloatingNotification
              prefixIcon={<Icons.StatusAlert />}
              type="destructive"
              text="Fix email value to save account details."
              onClose={() => setState(false)}
            />
          </Box>
        )}
        <Cell span={6}>
          <FormField label="First name">
            <Input defaultValue="John" />
          </FormField>
        </Cell>
        <Cell span={6}>
          <FormField label="Last name">
            <Input defaultValue="Smith" />
          </FormField>
        </Cell>
        <Cell>
          <FormField
            label="Email address"
            status="error"
            statusMessage='Provide the email in format "your@email.com"'
          >
            <Input defaultValue="asfljaokfjalk" type="email" />
          </FormField>
        </Cell>
      </Layout>
    </CustomModalLayout>
  );
};
```

#### Inline with content

Place notifications first in the section that they apply to.

```jsx
<Card hideOverflow>
  <Card.Header
    title="Earn points"
    subtitle="These are the ways customers earn points."
  />
  <FloatingNotification
    type="warning"
    fullWidth
    prefixIcon={<Icons.StatusWarning />}
    text="You don't have ways of Earning Points enabled, so users can't collect points. Enable at least one of the way below."
  />
  <TableListItem
    showDivider
    options={[
      {
        value: (
          <FormField label="Inactive" labelPlacement="right">
            <ToggleSwitch size="medium" />
          </FormField>
        ),
        width: 'auto',
      },
      {
        value: (
          <Box direction="vertical">
            <Text size="small" weight="bold">
              Make a Restaurant Order
            </Text>
            <Text size="small">Give 1 points for every 1$ spent.</Text>
          </Box>
        ),
      },
      {
        value: (
          <IconButton priority="secondary" size="small">
            <Icons.MoreSmall />
          </IconButton>
        ),
        width: 'auto',
      },
    ]}
  />
  <TableListItem
    options={[
      {
        value: (
          <FormField label="Inactive" labelPlacement="right">
            <ToggleSwitch size="medium" />
          </FormField>
        ),
        width: 'auto',
      },
      {
        value: (
          <Box direction="vertical">
            <Text size="small" weight="bold">
              Sign Up to the Site
            </Text>
            <Text size="small">Give 100 points after sign up.</Text>
          </Box>
        ),
      },
      {
        value: (
          <IconButton priority="secondary" size="small">
            <Icons.MoreSmall />
          </IconButton>
        ),
        width: 'auto',
      },
    ]}
  />
</Card>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `buttonProps` | `ButtonAsButtonProps<{ label?: ReactNode; }> \| ButtonAsAnchorProps<{ label?: ReactNode; }> \| ButtonGenericProps<{ label?: ReactNode; }> \| ButtonAsComponentProps<{ label?: ReactNode; }>` | — | Accepts props for a `<Button/>` action. The button is rendered only when this object isn't empty. Use `label` to set its text. |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `fullWidth` | `boolean` | — | Is notification full width (removes left and right border, border radius, more height and bigger paddings) |
| `onClose` | `MouseEventHandler` | — | Defines a callback function which is called when the close button is clicked. |
| `prefixIcon` | `ReactElement` | — | An icon element to appear before content. |
| `showCloseButton` | `boolean` | `true` | Specifies whether the close button is displayed. |
| `text` | `ReactNode` | — | The text content of the notification. |
| `textButtonProps` | `ButtonAsButtonProps<{ label?: ReactNode; }> \| ButtonAsAnchorProps<{ label?: ReactNode; }> \| ButtonGenericProps<{ label?: ReactNode; }> \| ButtonAsComponentProps<{ label?: ReactNode; }>` | — | Accepts props for a `<TextButton/>` action. The text button is rendered only when this object isn't empty. Use `label` to set its text. |
| `type` | `"warning" \| "standard" \| "destructive" \| "premium" \| "dark" \| "success" \| "preview"` | `'standard'` | Controls the type of the notification, which sets its color. |
| `width` | `string` | — | The width of the content container of the notification. |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { FloatingNotificationUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { FloatingNotificationTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { FloatingNotificationTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { FloatingNotificationTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `clickButton` | Clicks notification button. |
| `getButtonLabel` | Get the notification button's text. |
| `clickTextButton` | Clicks the notification text button. |
| `getTextButtonLabel` | Get the notification text button's text |
| `clickCloseButton` | Clicks the notification close button |
| `getText` | Get the notification text. |
| `isButtonAs` | Checks whether button with passed tag name exists. |
| `getButtonHref` | Get the notification button href attribute's value. |
| `getButtonAttr` | Get the notification button attribute's value by name. |
| `isTextButtonAs` | Checks whether text button with passed tag name exists. |
| `getTextButtonHref` | Get the notification text button href attribute's value. |
| `getTextButtonAttr` | Get the notification text button attribute's value by name. |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns UniDriver for the base element. |

## 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.331.0** (2026-10-01) — maintenance release, no component-specific changes
- **1.328.0** (2026-09-22) — maintenance release, no component-specific 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.295.0** (2026-07-03) — maintenance release, no component-specific changes
- **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.277.0** (2026-05-07) — 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.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.220.0** (2025-09-29) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.136.0** (2024-10-24) — deprecate: place component under the `DEPRECATED` section ([#14239](invalid-url))
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes