WordPress recovery mode is a safe mode that starts after a serious error, so you can still log in and switch off the plugin or themeA WordPress theme is a ready-made package that decides how your WordPress site looks and how its pages are laid out. Change the theme and the design changes. that broke your site. Instead of leaving you locked out behind a white screen, WordPress sends a special login link. It does not solve the problem, but it gets you back to a place where you can.
What is WordPress recovery mode?
Recovery mode pauses the code that failed, so an administrator can log in and switch off the broken plugin or theme.
When PHPPHP is a programming language that builds your web pages on the computer that hosts your site, just before they reach the visitor. WordPress runs on it. hits an error it cannot continue from, such as a function that does not exist, the page stops loading. For many years this meant a blank screen and a trip to the file manager. Recent versions of WordPressWordPress is free software for building and editing a website in your browser. It is written in PHP, so it builds each page when someone visits. detect many of these errors, show a message that the site has a technical problem, and email the administrator a link to enter recovery mode.
Inside recovery mode, WordPress pauses the pluginA WordPress plugin is an add-on you install in WordPress to give your site extra features, such as contact forms, SEO tools or a webshop. or theme that caused the error for your session only. You see the admin area with a notice about what failed, and you can deactivate it. Visitors still see the error until you do, because the pause applies to your own session.
What it means for your PHP site
Fatal errors are common right after a PHP versionA PHP version is a numbered edition of PHP, like 8.3. Each edition is looked after for a limited time, then gets security fixes only, then nothing. change, because older plugin and theme code may use things the new version removed. Recovery mode is therefore often the first thing you meet after an upgrade that went wrong. It tells you which component failed, which is the information you need to decide on a fix.
It also depends on email working. The link goes to the administration address stored in the settings, and many shared hosts limit outgoing mail. If that address belongs to someone who left, or mail from the site never arrives, recovery mode is out of reach. Check that address now, while the site is healthy.
How to use it and what to check
Open the email titled something like “Your site is experiencing a technical issue” and follow the link. Log in as usual. WordPress shows which plugin or theme it paused. Deactivate it from the Plugins screen, or update it if a newer version exists. Then leave recovery mode and reload the front end in a private window to see what visitors see.
If you still cannot find the cause, turn on logging with WP_DEBUGWP_DEBUG is a WordPress setting that makes hidden errors visible or saves them to a file, which helps find out why a site shows a blank page. and read the entries in the error logAn error log is a file where your website's software writes down what went wrong, with the time and place. It is the first thing to check when a site breaks.. Make a backupA backup is a separate copy of your website's files and database, so you can bring the site back after a mistake, a hack or a failed update. before you remove anything on a live site.
When recovery mode is not enough
Sometimes the error is in the WordPress core, in a file edited by hand, or in the PHP configuration, and recovery mode does not catch it. Sometimes the site is also hacked and the error is a side effect. In those cases, stop experimenting. Every extra change makes the cause harder to find.
If your site is down and you cannot get in, our help to fix your WordPress website is built for this moment. If the error appeared because of an old plugin on an old PHP version, the longer-term answer is a planned move, and we can update PHP in WordPress for you.
When to act
Act when you see the critical error message, when the recovery email arrives, or when a plugin update leaves the site half broken. Do not wait for the next morning: a site that shows errors loses visitors every hour.
Frequently asked questions
Where is the recovery mode email sent?
WordPress sends it to the administration email address set in Settings, General. If that address is outdated or the server cannot send mail, you will not receive the link, so check the address before you need it.
Does recovery mode fix the error?
No. It lets you log in to a limited admin area where the broken plugin or theme is paused. You still have to update, replace or remove the cause yourself.
What if I get no recovery email and cannot log in?
Then you need file access. Renaming the plugin folder through SFTP or your hostingWeb hosting is the service that keeps your website's files on a computer that is always online, so visitors can open your site at any time. file manager makes WordPress stop loading that plugin. If you are unsure, ask for help instead of guessing on a live site.
Can a PHP update trigger recovery mode?
Yes. A plugin or theme that does not work with the new PHP version can cause a fatal error. Recovery mode is then the way back into the admin, after which you decide how to fix it.