> 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`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: showToast(config: ToastConfig)

# Method package: wixDashboard

# Method menu location: wixDashboard --> showToast

# Method Link: https://dev.wix.com/docs/velo/apis/wix-dashboard/show-toast.md

# Method Description:

Displays a toast notification at the top of a dashboard page.

![Toast notification](https://wixmp-833713b177cebf373f611808.wixmp.com/images/velo-images/media_toast_example.png "Toast notification")

> **Note:** This function can only be used in page code files for dashboard pages created in the [Wix Editor](https://support.wix.com/en/article/velo-working-with-dashboard-pages) or with [Wix Blocks](https://support.wix.com/en/article/wix-blocks-creating-and-managing-blocks-dashboard-pages).

The `showToast()` function returns an object containing a key called `remove`. 
The value of `remove` is a function that removes the toast from the page.

Use the `config` parameter to:
* Control the toast's content and appearance.
* Set callback functions to run when the user sees or closes the toast.
* Create a clickable call-to-action that displays in the toast.

When showing multiple toasts, requests to display toasts may be queued and the toast may not be displayed immediately. Toasts with a higher
priority level are displayed first. A toast's priority is defined using the `config.priority` parameter. Toasts with the same priority level are displayed in the order
they're requested. 

> **Note:** When the timeout parameter is set to `"none"` the toast is rendered into the page layout and pushes the rest of the page down. When timeout is set to `"normal"`, the toast appears on top of other content on the page.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Display a success toast when a product is updated

```javascript
import { showToast } from 'wix-dashboard';

// ...

const config = {
  message: 'Product updated successfully!',
  type: 'success',
}

showToast(config);
```

## Display an error toast with a 'Learn more' link

```javascript
import { showToast } from 'wix-dashboard';

// ...

const config = {
  message: 'Product update failed.',
  timeout: 'none',
  type: 'error',
  priority: 'low',
  action: {
    uiType: 'link',
    text: 'Learn more',
    removeToastOnClick: true,
    onClick: () => {
      console.log('Learn more clicked!');
    },
  },
};

showToast(config);
```

## Remove a displayed toast

```javascript
import { showToast } from 'wix-dashboard';

// ...

const config = {
  message: 'Product updated successfully!',
  type: 'success',
  timeout: 'none',
}
const toastRemover = showToast(config);
setTimeout(toastRemover.remove(), 5000);

/* Promise resolves a function that removes the toast. */
```

## Remove a displayed toast when a button on the page is clicked

```javascript
import { showToast } from 'wix-dashboard';

// ...

const config = {
    message: 'Product updated successfully!',
    type: 'success',
    timeout: 'none',
}
let toastRemover = showToast(config);
$w('#removeToastButton').onClick(() => {
    toastRemover.remove();
})

/* Promise resolves a function that removes the toast. */
```

---