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

## Article: NavigationToast Component

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

## Article Content:

# NavigationToast

_Components/Feedback_

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

## Overview

```jsx
<NavigationToast key="back-to-settings">Back to settings</NavigationToast>;
```

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.

```jsx
() => {
  const [showDismissibleToast, setShowDismissibleToast] = React.useState(true);

  return (
    <Box padding="20px" gap="20px" direction="vertical">
      {showDismissibleToast && (
        <NavigationToast
          key="dismissible-default"
          onDismiss={() => setShowDismissibleToast(false)}
          prefixIcon={<Icons.ArrowBentUpLeft />}
        >
          Dismissible (default)
        </NavigationToast>
      )}

      <NavigationToast
        key="non-dismissible"
        dismissible={false}
        prefixIcon={<Icons.ArrowBentUpLeft />}
      >
        Non-dismissible
      </NavigationToast>
    </Box>
  );
};
```

#### Prefix icon

Define prefix icon with `prefixIcon` prop.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <NavigationToast key="default-icon" prefixIcon={<Icons.ArrowBentUpLeft />}>
    {'Default icon'}
  </NavigationToast>
  <NavigationToast
    key="custom-icon"
    prefixIcon={<Icons.ArrowUp />}
    dismissible={false}
  >
    {'Custom icon'}
  </NavigationToast>
</StorybookComponents.Stack>;
```

#### Timeout

Define if toast should disappear automatically with `duration` prop.

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

```jsx
(() => {
  const makeId = () => Math.random().toString(36).substring(2, 9);

  const Example = () => {
    const [toasts, setToasts] = React.useState([]);

    const removeToast = (id) => {
      setToasts((toasts) => toasts.filter((toast) => toast.id !== id));
    };

    const addToast = (id, toast) => {
      setToasts((toasts) => [...toasts, { id, toast }]);
    };

    const createNavigationToast = (children, duration = 0) => {
      const id = makeId();

      addToast(
        id,
        <NavigationToast
          key={id}
          duration={duration}
          onDismiss={() => {
            removeToast(id);
          }}
        >
          {children}
        </NavigationToast>,
      );
    };

    return (
      <>
        <Box gap={1}>
          <Button
            size="small"
            onClick={() => createNavigationToast('No timeout (default)', 0)}
          >
            No timeout (default)
          </Button>
          <Button
            size="small"
            onClick={() => createNavigationToast('Custom timeout', 7000)}
          >
            Custom timeout (7 seconds)
          </Button>
        </Box>
        <ToastContainer>{toasts.map(({ toast }) => toast)}</ToastContainer>
      </>
    );
  };

  return Example;
})();
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `children` *(required)* | `ReactNode` | — | Content to display 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` | `0` | Time in milliseconds before the toast dismisses automatically. When set to `0` or `null`, the toast remains indefinitely. |
| `id` | `string` | — | Sets the `id` HTML attribute of the toast root element. |
| `onAction` | `MouseEventHandler` | — | 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. |
| `prefixIcon` | `false \| IconElement` | ``<Icons.ArrowBentUpLeft />`` | Custom icon displayed at the start of the toast content. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getContent` | Retrieves the content of the toast. |
| `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. |

## 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](invalid-url))