Review failed jobs and the dead-letter queue, and retry safely
Failed Jobs lists every failed run; the Dead-letter queue lists work that exhausted its attempts (jobs and emails). A super administrator can retry only jobs whose handler is safe to run again.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
Open Failed Jobs
Open "System Operations" and click "Failed Jobs" (address /admin/system/failed-jobs). Each row is a failed run with "Job", "Trigger", "Attempt", "Started", "Duration (ms)", "Retryable now" and the "Error".
Retry
On a row with "Retryable now: yes" click the row button "Retry job" and confirm. The job runs again immediately through its registered handler and the new run is recorded. A job already succeeding, or one with no safe handler, is refused with the reason.
Open the dead-letter queue
Click "Dead-letter queue" (address /admin/system/dlq). A job is dead-lettered after failing its maximum attempts in a row. Emails the outbox gave up on appear too, with the recipient address partly hidden.
Replay
Click "Replay" on a row and confirm. A job runs again; an email goes back into the outbox for the next drain. Nothing is deleted.
Failed work is visible with its error; a retry or replay really runs it again and the outcome is recorded, or you are told why it was refused.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation