WordPress White Screen After Plugin Update Checklist
A white screen after a plugin update usually means WordPress hit a fatal PHP error. The site may show a blank page, wp-admin may stop loading or only some pages may fail. This checklist helps you recover without making the situation worse.
Common causes
- Plugin update is incompatible with your PHP version.
- Plugin conflicts with another plugin.
- Theme conflict.
- Memory limit is too low.
- Cached files conflict with new plugin code.
- Fatal PHP error stops page rendering.
Checklist
- Do not keep refreshing and changing settings randomly.
- Check if wp-admin still works.
- Check Nginx and PHP error logs.
- Identify the last plugin updated.
- Disable the suspected plugin through file manager or SSH if wp-admin is inaccessible.
- Clear cache after disabling the plugin.
- Check PHP version compatibility.
- Restore backup if disabling the plugin is not enough.
- Update in staging next time if the site is important.
- Document the plugin version that caused the issue.
Final check
The goal is to restore access first, then investigate compatibility. Do not update more plugins while the site is already broken.
When to Use This Checklist
Use this checklist when WordPress shows a blank page or white screen after updating a plugin.
Required Tools
WordPress admin access if available, SSH or file manager, backup, Nginx log, PHP error log, cache plugin access
Before You Start
Stop making new changes until you identify the plugin or error that caused the white screen.
Structured Checklist Steps
- Check if wp-admin works.
- Read error logs.
- Identify the recently updated plugin.
- Disable the plugin by renaming its folder if needed.
- Clear cache.
- Check PHP compatibility.
- Restore backup if needed.
- Test frontend and admin.
- Record the failing plugin version.
Verification Steps
- Homepage loads.
- wp-admin loads.
- Error log stops showing fatal errors.
- Core pages work.
- Cache is cleared.
Rollback Plan
If the site remains broken after disabling the plugin, restore the latest clean backup or switch to a default theme temporarily to isolate the issue.
Common Mistakes
- Updating more plugins after the site breaks.
- Deleting plugin data before backup.
- Ignoring PHP fatal error logs.
- Clearing cache before identifying the cause.
- No backup before plugin updates.
Related Commands
sudo tail -n 100 /var/log/nginx/error.log
cd /var/www/example.com/wp-content/plugins
mv plugin-folder plugin-folder-disabled
wp plugin list