Skip to content

How to Fix a WordPress Critical Error After a Plugin Update

A safe troubleshooting order for WordPress critical errors after plugin updates using Recovery Mode, plugin deactivation, debug logging, rollback and staging.

Last updated: Sep 19, 20265 min read

WordPress critical error after a plugin update: start with recovery, not random edits

If WordPress shows “There has been a critical error on this website” immediately after a plugin update, the fastest safe route is to preserve the current state, identify the failing component and restore access before changing unrelated settings.

Quick order: check the admin recovery email → use Recovery Mode if available → deactivate the failing plugin → confirm the site loads → inspect the error log → decide whether to roll back, replace or fix the plugin.
WordPress critical error screen and Recovery Mode workflow after a plugin update
Use a recreated screenshot so no client domain, email address or server path is exposed.

1. Check WordPress Recovery Mode first

Modern WordPress can send the site administrator an email when it detects certain fatal PHP errors. The message may include a Recovery Mode link that lets an administrator sign in while the problematic plugin or theme is paused for that session. If the email arrives, this is usually the cleanest first route because it reduces the need to edit files directly.

Inside Recovery Mode, look for the component named in the error notice. Deactivate it temporarily, then open the public site in a separate browser window to verify that the critical error is gone.

2. If you cannot enter wp-admin, deactivate the plugin from the file system

If the recovery email does not arrive or the dashboard remains inaccessible, use your host’s file manager, SFTP or SSH. In wp-content/plugins/, rename only the suspected plugin folder. WordPress will no longer find that plugin at its expected path and will deactivate it.

wp-content/plugins/example-plugin/
→
wp-content/plugins/example-plugin-disabled/

Reload the site. If it returns, you have strong evidence that the failure is connected to that plugin or an interaction involving it. Do not immediately delete the folder; keeping it available makes rollback and comparison easier.

WordPress plugin folder renamed to disabled in a hosting file manager to recover from a critical error
Highlight only the relevant folder and avoid showing usernames or account paths.

3. Turn on logging without displaying errors to visitors

When you need the exact PHP error, WordPress debugging can write errors to a log file. On a live site, avoid displaying raw errors publicly because they can expose paths or technical details. A common diagnostic configuration is:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Add the settings in wp-config.php before the line that tells you to stop editing. Then reproduce the error once and inspect wp-content/debug.log. After diagnosis, disable debugging on the live site.

4. Read the error for the first useful clue

Undefined function or class

Often points to a missing dependency, load-order problem or incompatible plugin version.

Allowed memory exhausted

The immediate failure is memory-related, but raising the limit is not a substitute for finding unusually heavy code or a runaway process.

Syntax or parse error

Frequently indicates broken custom code, a failed file deployment or code that requires a different PHP version.

5. Decide between rollback, update or replacement

If the plugin update caused the failure, the next action depends on what the log shows. A known compatible previous version may be the right temporary rollback. In other cases, another plugin, the theme or PHP version is the real compatibility boundary. Avoid treating “install the old version forever” as the final fix.

Restore serviceKeep the failing component disabled or roll back to a known working version.
Reproduce on stagingClone the site and test the update away from visitors so you can isolate conflicts safely.
Check dependency changesReview PHP requirements, related plugins, theme hooks and custom snippets that interact with the failing component.
Apply the durable fixUpdate the dependency, replace abandoned code, patch the custom integration or move to a supported plugin version.
WordPress critical error troubleshooting flow from Recovery Mode to plugin deactivation, debug log, rollback or fix
A decision-tree visual makes the diagnostic order much easier to follow.

How to stop the same failure from happening on the next update

  • Keep a current restorable backup before updates
  • Use staging for higher-risk changes
  • Update in controlled batches, not every component at once
  • Record the versions changed during each maintenance window
  • Test forms, checkout and other business-critical flows afterwards
  • Remove abandoned plugins instead of carrying them indefinitely

If you maintain the site yourself, the WordPress guides can help you build a safer update workflow. If the error keeps returning or the site has several unresolved compatibility issues, Blyfa’s website support service can handle the diagnosis and ongoing maintenance as one process.

Need the site stable before the next update?

Document the failing component, preserve a restore point and fix the dependency rather than repeatedly treating the symptom.

Get WordPress support
Frequently asked questions
What usually causes a WordPress critical error after a plugin update?

Common causes include plugin conflicts, theme compatibility, unsupported PHP versions, missing dependencies, memory exhaustion or custom code that no longer matches the updated plugin.

Can I disable a plugin if wp-admin is inaccessible?

Yes. If you have hosting file access, renaming the suspected plugin folder inside wp-content/plugins can force WordPress to deactivate it.

Should WP_DEBUG be left enabled on a live website?

No. Use debugging temporarily for diagnosis, log errors rather than displaying them publicly, and disable it again after you have the information you need.

Is rolling back the plugin a permanent fix?

Usually it is a temporary recovery step. You should still identify the compatibility issue, update the dependency or replace unsupported code before the next update attempt.

Comments

Short comments related to this article.

0 comments
No account is required. Your comment will be held for review before it appears.
Type the code exactly as shown
This code is generated by the site and expires automatically.
No comments yet.