How to use the Failed Notifications screen (Notifications)
Notification emails the provider refused, and delivery failures recorded when nothing could be queued.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
Open the page
Sign in as an administrator and use Admin sidebar → Notifications → Failed Notifications, or go to /admin/notifications/failed. The heading reads "Failed Notifications".
Know where the data comes from
This page reads i8_email_outbox (failed, notification:*) and i8_notification_deliveries (FAILED). Columns: Source, Kind, Recipient, Status, Error, Attempts, Retry, When.
Retry an email
The check icon titled "Retry (re-queue the email)" puts a failed outbox email back in the email queue after confirmation. The banner confirms; delivery itself happens when the email engine processes the queue.
Non-retryable rows
Rows from the delivery log (for example "email engine not configured") cannot be retried; fix the cause and send again.
Use the shared controls
Use the shared controls: the search box ("Search records, hashes, DIDs...") filters rows by any text; "Status:" offers ALL, FAILED; "Page Size:" sets 10, 15, 25 or 50 rows; Refresh reloads; Export saves the rows currently loaded as a JSON file. The line "Data:" under the heading names the real source.
Failed emails are visible and can be re-queued; other failures say why they cannot.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation