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

Copy

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

Copy

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.

Copy

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.

Copy

Close Button

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

Copy

Prefix

Add more context for the notification purpose with prefixIcon.

Copy

Common use case examples

In front of content

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

Copy

Inline with content

Place notifications first in the section that they apply to.

Copy

Code

Copy

Props

NameTypeDefaultDescription
buttonPropsButtonAsButtonProps<{ 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.
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
fullWidthboolean—Is notification full width (removes left and right border, border radius, more height and bigger paddings)
onCloseMouseEventHandler—Defines a callback function which is called when the close button is clicked.
prefixIconReactElement—An icon element to appear before content.
showCloseButtonbooleantrueSpecifies whether the close button is displayed.
textReactNode—The text content of the notification.
textButtonPropsButtonAsButtonProps<{ 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.
widthstring—The width of the content container of the notification.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
clickButtonClicks notification button.
getButtonLabelGet the notification button's text.
clickTextButtonClicks the notification text button.
getTextButtonLabelGet the notification text button's text
clickCloseButtonClicks the notification close button
getTextGet the notification text.
isButtonAsChecks whether button with passed tag name exists.
getButtonHrefGet the notification button href attribute's value.
getButtonAttrGet the notification button attribute's value by name.
isTextButtonAsChecks whether text button with passed tag name exists.
getTextButtonHrefGet the notification text button href attribute's value.
getTextButtonAttrGet the notification text button attribute's value by name.
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns 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)
  • 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

Last updated: 22 October 2026

Did this help?