Overview
Go Headless

Changelog

Wix Design System (WDS)
Introduction
About Wix Design System
Get started developing
Get started designing
Theming
Wix Design System AI

Guidelines
Themes
Interaction & Behavior
Guidelines
Localization

Patterns
Patterns Overview
Table Pattern
Grid Switch Pattern
Grid Pattern

Foundations
Tokens and Theming basics
Icon Theming

Contributing
AI-Assisted Development
Component Structure
Contributing to Wix Design System
Creating a New Component
Creating a Pull Request
Deprecating a Component
Documenting
Fixing a Bug
Test Drivers
Contributing Tokens
Token Migration Guidelines
Updating Props
Writing Tests

Components
Actions
Animations
Charts
Feedback
Badge Component
BadgeSelect
CircularProgressBar Component
CounterBadge Component
FloatingNotification Component
LiveRegion Component
Loader Component
NavigationToast Component
SectionHelper Component
SkeletonGroup Component
StatusToast Component
TopBanner Component
Form
Layout
Lists
Mechanisms
Media
Navigation
Overlays
Panels
Typography
In This Article

  1. Overview
  2. Code
  3. Testkit
  4. Changelog

NavigationToast

Components/Feedback

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

Overview

Copy

Navigation toast is a toast with a single link that takes users to a related page or place, such as their settings or back to the top of a list. It stays on screen until users dismiss it, unless you set a duration.

Do

  • Provide a clear action that's explicit and guides users to the intended destination, such as "Go to Settings" or "Scroll back to top".
  • Only use the toast to direct users to environments or actions that are immediately relevant to their current context.
  • Use short, actionable text for the title and description.

Don't

  • Don't use it as a notification. Use <StatusToast/> instead.
  • Don't use it as the primary navigation element of your app. Use it only as a supplementary guide.
  • Don't leave the toast displayed indefinitely if it's no longer relevant or actionable.
  • Don't add unrelated or out-of-context actions to the toast.

Feature examples

Close button

Control whether navigation toast can be dismissed by a user with dismissible prop.

Copy

Prefix icon

Define prefix icon with prefixIcon prop.

Copy

Timeout

Define if toast should disappear automatically with duration prop.

By default, toast is persistent and duration is set to 0 milliseconds.

Copy

Code

Copy

Props

NameTypeDefaultDescription
children (required)ReactNode—Content to display in the toast.
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
dismissibleboolean—Whether the toast should render the dismiss button.
dismissLabelstring—Aria label for the dismiss button.
durationnull | number0Time in milliseconds before the toast dismisses automatically. When set to 0 or null, the toast remains indefinitely.
idstring—Sets the id HTML attribute of the toast root element.
onActionMouseEventHandler—Callback triggered when the toast action is performed.
onDismiss(event?: MouseEvent<Element, MouseEvent> | undefined) => void—Callback function called whenever the user clicks the dismiss button.
prefixIconfalse | IconElement<Icons.ArrowBentUpLeft />Custom icon displayed at the start of the toast content.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
getContentRetrieves the content of the toast.
getRole—
getAriaLive—
isVisible—
isDismissible—
getDismissButton—
dismissButton—
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.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.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.291.0 (2026-06-19) — maintenance release, no component-specific changes
  • 1.273.0 (2026-04-30) — maintenance release, no component-specific changes
  • 1.271.0 (2026-04-22) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.254.0 (2026-02-03) — maintenance release, no component-specific changes
  • 1.242.0 (2025-12-19) — maintenance release, no component-specific changes
  • 1.228.0 (2025-11-18) — maintenance release, no component-specific changes
  • 1.216.0 (2025-09-01) — maintenance release, no component-specific changes
  • 1.144.0 (2024-12-03) — feat: introduce new component (#14310)

Last updated: 22 October 2026

Did this help?