Message notifications
Depending on your requirements, Mailpit provides various methods to notify you when new messages are received.
Please note that notifications require a working WebSocket connection to the Mailpit server. If you are using a proxy to access Mailpit, please ensure your WebSocket is routing correctly.
Favicon counter
The browser tab favicon includes an unread message counter, which will automatically update when new messages are received. This is available on desktop browsers only, and when any open tab is running Mailpit.
Message toast
When new messages arrive, Mailpit will display a clickable toast (element) at the bottom right of the page, showing a brief summary of the message. Clicking on this will open the message. This is only visible when viewing the Mailpit web UI, and the toasts automatically disappear after a few seconds. This feature is automatically disabled if browser notifications are enabled.
Browser notifications
You can optionally enable browser notifications by clicking on the “bell” icon at the bottom left. If enabled, toast notifications are disabled. You must have Mailpit open in any tab for notifications to work.
Browser notifications are only enabled if viewing the web UI via the
localhost hostname, or if accessing the web UI via
HTTPS. This is not a Mailpit limitation but rather due to standard web browser security features.
Webhooks
You can integrate third-party tools by setting a webhook for Mailpit to call when new messages arrive. See webhook integration for more information.
Edit this page