Safeguard
Developer Tools•

Does WordPress roll back a plugin update that crashes the site?

WordPress can detect a PHP fatal error after a plugin auto-update and restore the previous version. What that covers, what it misses, and what to add.

Safeguard Security Team
3 min read

Partly. WordPress has a rollback feature for plugin updates that checks the homepage after an update and restores the previous version if it finds a PHP fatal error. It does not catch logic bugs, broken layouts, checkout failures or a malicious update that runs without crashing. Treat it as a crash guard, not a safety review.

What the proposal describes

The core merge proposal for rollback of auto-updates explains the background. Core updates have had automatic rollback since WordPress 3.7, but plugins did not. Recovery mode arrived in 5.2 but needs an administrator. The proposal lists three steps: a move directory function in 6.2, rollback when manual plugin or theme updates fail in 6.3, and rollback for automatic plugin updates, which the post tags for 6.6. Check your site's version rather than assuming.

The mechanism, as described:

  1. A plugin is briefly deactivated, updated and reactivated.
  2. WordPress makes a loopback request to the homepage.
  3. If it returns a PHP fatal error, an error handler logs the message and the earlier version is restored.
  4. The administration email gets a notice of the failed update and rollback.
  5. Other queued updates continue, and the next auto-update check will try the same plugin again.

Maintenance mode is also on for the duration of automatic updates.

What it does not catch

FailureCaught?
PHP fatal error on the homepageYes, by design
Fatal error only on a checkout or admin pageNot by a homepage check
Visual or layout regressionsNo
Silent data corruptionNo
A backdoor that runs quietlyNo

The proposal itself describes detection through a loopback to the homepage, so a fault on other pages would not trigger it.

What to add around it

A short agency routine

  1. Make sure the admin email on each site goes to a monitored mailbox.
  2. Search that mailbox weekly for failed update notices.
  3. Pin or pause a plugin that keeps failing and investigate on staging.
  4. Tell the client what happened in plain words.

Why a repeated rollback matters

The proposal notes that after a rollback, the next auto-update check will try the same plugin again. A plugin that keeps failing can therefore generate the same notice again and again until someone acts. Treat the second notice as an incident ticket, not noise. Pin the plugin if you must, ask the vendor for a fix, and check whether a PHP or WordPress version mismatch is the cause.

Quick check

Is rollback enabled for every site?

It depends on the WordPress version and on whether the site uses plugin auto-updates, so check each site.

Does it replace backups?

No. It restores one plugin folder after a detected crash, not content or the database.

Sources

Last reviewed: 19 October 2026.

Never miss an update

Weekly insights on software supply chain security, delivered to your inbox.

Self-healing security runs on Safeguard.

Your first fix PR is minutes away.

No sales call required, even your agent can complete the purchase over MCP.