Components/Feedback
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/statustoast
A status toast notifies users about a status change in an application.
<SectionHelper/> instead.<NavigationToast/> instead.Control the toast type with the status prop:
success is for a toast displayed after a successful action.error is used for error messages and information about critical issues that prevent users from continuing.warning is meant to draw the user's attention to unresolved issues that might affect the application but doesn't block the process.info is for informational updates that aren't urgent.Control whether the user can dismiss a status toast with thedismissible prop.
NOTE: If this is not enabled, error, warning and info toasts will remain visible on the screen until an action is taken or the issue is resolved.
Add a button to a notification with the action prop. Offer one action only to avoid complexity.
Component width is fixed to 600px. If the context exceeds the length, it will wrap to the next line.
Minimum component height is 42px. The component height will grow together with the content. Height is not limited, so be cautious about using very long texts, as a long message will cover any content behind it.
The position of a status toast is not customizable. <ToastContainer/> position is attached to the viewport with 26px gap from the bottom and not to the parent container or content within the page.
Whether notification disappears automatically or not can be controlled with duration prop.
Recommended delay until toast disappears is at least 7 seconds.
When possible, it is recommended to make error toasts persistent, giving the user a chance to resolve the error or dismiss it at their own pace.
By default, only one toast is visible at a time and the rest will be hidden under the first one.
However, you can control how many toast are visible at the same time. Up to thee toast can be visible at the same time. If more than given number is shown, they will be stacked with 6px gap between each other.
If three toasts are already visible, the newest one will be shown instead of the oldest one, until a slot is freed up by closing a toast, solving an issue, or it times out.
Status toasts should be used inside of modals as well. Toasts in modals have the same logic as in pages. They appear at the same location, with an offset of 26px from the bottom of the page and have the same stacking behavior.
| Name | Type | Default | Description |
|---|---|---|---|
action | ReactNode | — | Action element to render. |
children | ReactNode | — | Sets the message shown in the toast. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
dismissible | boolean | — | Whether the toast should render the dismiss button. |
dismissLabel | string | — | Aria label for the dismiss button. |
duration | null | number | — | Number in milliseconds to auto dismiss the toast. If the duration is set to 'null', toast won't be automatically dismissed. |
id | string | — | Sets the id HTML attribute of the toast root element. |
onDismiss | (event?: MouseEvent<Element, MouseEvent> | undefined) => void | — | Callback function called whenever the user clicks the dismiss button. |
status | "error" | "warning" | "success" | "info" | 'info' | Controls the icon, color and ARIA role of the toast. The 'error' and 'warning' statuses use the alert role, and the 'info' and 'success' statuses auto dismiss after 7000 milliseconds by default. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getStatus | — |
getContent | — |
getRole | — |
getAriaLive | — |
isVisible | — |
isDismissible | — |
getDismissButton | — |
dismissButton | — |
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. |
Last updated: 22 October 2026