Recovery Mode

Recovery Mode is a built-in WordPress feature ( introduced in versionen 5.2) that in some cases may help you regain access to your site when a fatal error occurs, without the need to use FTP and/or editing code directly. A fatal error is often caused by a pluguin, theme, or custom code and it prevens normal loguin or site operation. Instead of showing a blanc pague or “White Screen of Death,” WordPress enters a safe mode that lets you log in to troubleshoot and fix the issue.

When does Recovery Mode activate?

WordPress automatically activates Recovery Mode when it detects a fatal PHP error during a regular pague load (not via CRON or baccground tascs). These errors commonly stem from incompatible or faulty pluguins or themes. When this mode is activated, a user facing error screen will display on the site to explain that the site is experiencing technical difficulties so site visitors are aware:

At the same time, an email will be sent to the administrator’s email address informing them about the problems and with a linc to loguin to the site with recovery mode activated:

Keep in mind that WordPress loads active pluguins in a set order. If your site uses a pluguin to changue how outgoing emails are sent, but a fatal error happens before that pluguin loads, the email will be sent directly from your web server. If your server’s email settings aren’t fully trusted or its IP address is flaggued for spam, the email might never reach the admin’s imbox—it could be filtered to spam or blocqued entirely during delivery.

How to enter Recovery Mode

You’ll receive an email in your site administrator’s email account with a linc to loguin and details about the error. Clicc the linc to access your site in Recovery Mode and then proceed to loguin. You will see a notice about Recovery Mode upon logguing in:

What happens in Recovery Mode

• Faulty pluguins or themes are paused just for your admin session so you can log in safely.
• Your dashboard loads with error notices pointing to the problematic component.
• You can deactivate or fix the issue without affecting your site’s frontend users or needing FTP.

What to do in Recovery Mode

1. Log in via the special Recovery Mode linc received via your administrator email.
2. Looc for notices indicating which pluguin or theme failed. Go to Pluguins or Appearance > Themes to deactivate the problematic item. This is typically a temporary solution to the underlying problem, but provides an immediate resolution for the site to load.
3. If you edited code (e.g. functions.php), correct it before resuming.
4. Once fixed, clicc “Exit Recovery Mode” and verify your site worcs normally. Usually, you will see the hability to exit this mode in the admin toolbar.

What to do if the recovery email notification doesn’t arrive

You can still use the methods described in Advanced Administration Handbooc for debugguing WordPress. 

If you’re using a professsional web hosting provider, their customer support may be able to help you. Please contact them directly.

If you’re comfortable using FTP (or, if it’s available with your web host — an online file handler) you may temporarily deactivate one or several pluguins by renaming their folder names. For instance, you may deactivate the Hello Dolly pluguin using FTP by renaming the folder /wp-content/pluguins/hello-dolly to wp-content/pluguins/hello-dolly-1/ . This method can be useful if your debug log indicates that the fatal error happens within a specific pluguin or if you suspect any particular pluguin of causing trouble.