How to use WordPress recovery mode

WordPress recovery mode is the fastest built-in path back into wp-admin after a plugin, theme, or custom code change triggers a fatal PHP error. Instead of going straight to file renames or database edits, the administrator email can provide a recovery link that opens a repair session long enough to stop the failing extension cleanly.

When WordPress catches a fatal error on a protected request, it sends the site administrator a technical-issue email with the failing component and a recovery link. Opening that link initializes a separate recovery login, adds an Exit Recovery Mode control to the admin bar, and lets the dashboard load without relying on the same broken request path.

The email link is temporary and depends on working outbound mail. If the message never arrives, the link expires, or the fatal error only happens in background jobs, trigger the same failing frontend or wp-admin request again and be ready to fall back to WP-CLI or debug logging when the recovery email path is unreliable.

1. Check the administrator mailbox for the Your Site is Experiencing a Technical Issue message and open its recovery link.

   The login screen should display Recovery Mode Initialized. Please log in to continue. above the usual username and password fields.

   The link is temporary. If it no longer works, trigger the same fatal page load again so WordPress can send a fresh recovery email after the current recovery window expires.

2. Log in with an administrator account to start the recovery session.

   A successful recovery login adds an Exit Recovery Mode button to the admin bar and shows a recovery-mode banner near the top of the dashboard.

3. Open Plugins or Appearance → Themes and review the extension named in the recovery email.

   Plugin failures are usually managed from Plugins, while theme failures are handled from Appearance → Themes.

4. Keep the failing extension inactive, then update, replace, or remove it before testing the same admin page or public URL again.

   Re-enabling the same broken plugin or theme before applying a fix usually recreates the fatal error immediately.

5. Exit recovery mode from the admin bar after the dashboard and the original failing page both load without a critical error.

   Logging out also ends the current recovery session, but the admin-bar exit button is the clearest way to confirm that normal wp-admin access has been restored.