This WordPress plugin load error usually points to a PHP crash, missing plugin files, or a blocked request; the fix is to find the log clue, disable safely, then reinstall cleanly.
You click a plugin page in wp-admin and get a blunt message: “an error was encountered while trying to load this plugin.” It feels like WordPress is refusing to tell you what’s wrong.
Most of the time, WordPress did try to load the plugin. Something failed mid-request, so the screen stops and the plugin UI never renders. The fastest path is to grab one clear clue, then act in a way that keeps you logged in. You can fix it.
Fixing An Error Was Encountered While Trying To Load This Plugin In WordPress
That message is a wrapper, not the root cause. It can show up after a plugin update, right after installing a new plugin, or when you open a settings page that triggers extra PHP code.
Think of it as a “plugin page didn’t finish loading” alert. The reason is usually one of these: a fatal PHP error, a missing file from a failed upload or update, a permission problem that blocks reads or writes, or a server rule that blocks the request.
| Clue You Can See | Likely Cause | First Check |
|---|---|---|
| It started right after an update | Partial update or PHP version mismatch | Check the error log for a fatal line |
| Only one plugin page fails | Bug inside that plugin or a missing file | Temporarily disable that plugin |
| Many admin pages act odd | Browser cache, minify, or a site-wide conflict | Try a clean browser session |
| You see “Critical error” emails too | Fatal error caught by WordPress recovery mode | Use the recovery link to log in |
| It happens only for one user | User role or security plugin rule | Test with an admin account |
If you can still reach wp-admin, you’re in a good spot. You can gather details without touching the database. If wp-admin is locked out, you can still disable the plugin with file access and get your dashboard back.
Start With Safe Checks That Don’t Change Files
These checks won’t change your site. They help you tell the difference between a browser issue and a server-side crash.
- Reload the page — Try a hard refresh (Ctrl + F5 on Windows) to bypass cached admin scripts.
- Open a private window — Sign in and repeat the click to rule out cookies, extensions, and stale cache.
- Try another browser — If the plugin page works elsewhere, the issue is local to one browser profile.
- Check your user role — Confirm you’re logged in as an administrator, not an editor or custom role.
- Test a plain admin page — Open Dashboard, Posts, and Settings. If those fail too, the issue is broader than one plugin.
If the error appears only on one settings screen, the plugin is still the prime suspect. If many admin screens fail, you may be dealing with cache or a site-wide script conflict.
Next, grab one solid signal from Site Health. In WordPress, go to Tools → Site Health and open the Status tab. Warnings about REST API, loopback requests, memory limits, or background tasks can line up with plugin pages that won’t load.
Get The Real Error Message From Logs
You don’t need to guess. When a plugin page fails, the server usually logged a line that names the file and the function where it stopped. Once you have that line, you can choose a fix that fits the cause.
Turn On A Short Debug Log Window
WordPress includes built-in debugging flags. Keep them on only long enough to capture the error, then turn them back off.
- Back up wp-config.php — Download a copy so you can restore it if you mistype anything.
- Edit wp-config.php — Add or update the debug constants near the bottom of the file.
- Log errors to a file — Set WP_DEBUG true, WP_DEBUG_DISPLAY false, and WP_DEBUG_LOG true.
- Recreate the failure — Go back to wp-admin and click the plugin page that triggers the message.
- Open debug.log — Look in wp-content/debug.log for the newest fatal or error line.
- Turn debug off — Set WP_DEBUG and WP_DEBUG_LOG back to false once you have the clue.
If you can’t or don’t want to edit wp-config.php, check your host’s PHP error log. Many hosts show it in a control panel, or you can access it through file manager tools.
What To Look For In The Log
- Fatal error — Look for “PHP Fatal error” plus a file path in wp-content/plugins.
- Missing file — Watch for “failed to open stream” or “No such file or directory.”
- Out of memory — Errors that mention memory size or allocation can break admin pages.
- Permission denied — This points to file ownership or restrictive permissions.
- Call to undefined function — This can signal an old PHP version or a plugin expecting a newer WordPress core.
Some plugin screens load data with background requests. If your PHP logs are clean, the request may be blocked before WordPress runs, so the page never finishes drawing. Also check REST API errors in Site Health.
- Check the Network tab — In your browser dev tools, reload the page and look for 401, 403, or 500 responses.
- Look for blocked admin-ajax.php — Many plugins rely on it; a firewall rule can stop the page from completing.
- Test with security rules paused — Turn off WAF or security plugin checks for a minute, retest, then switch them back on.
At this point, you have a target. If the log points to one plugin file, treat that plugin as broken until proven otherwise. If the log points to a theme file or a custom snippet plugin, the plugin page may just be the first place that code ran.
Disable The Plugin Without Losing Access
When the error blocks only one plugin screen, you can usually log in and disable the plugin from the Plugins list. If you can’t open that list, you can still disable the plugin with file access.
Try WordPress Recovery Mode First
On many sites, WordPress will email the admin email after it catches a fatal error. That email includes a recovery link that lets you log in with the broken plugin paused for that session.
- Search your inbox — Look for a message about a “critical error” and a recovery link.
- Use the link once — Log in, then go straight to Plugins and deactivate the plugin named in the message.
- Confirm the admin email — In Settings → General, check the admin email so recovery emails reach you.
Disable By Renaming The Plugin Folder
If recovery mode isn’t available, disable the plugin at the file level. Renaming a plugin folder makes WordPress treat it as missing, so it auto-deactivates it.
- Open file access — Use your host’s file manager or an FTP client.
- Go to wp-content/plugins — Find the folder that matches the plugin’s slug.
- Rename the folder — Add a suffix like -off to the folder name.
- Reload wp-admin — Sign in again and confirm the error screen is gone.
- Restore the name later — Keep it renamed until you finish the root fix.
Disable All Plugins When You Can’t Tell Which One
If the log isn’t clear, or you can’t reach the logs, you can disable all plugins in one move, then turn them on one by one to find the trigger.
- Rename the plugins folder — Change wp-content/plugins to plugins_old.
- Log in again — WordPress will treat all plugins as deactivated.
- Create a fresh plugins folder — Make a new wp-content/plugins directory.
- Move plugins back in batches — Add a few plugins at a time and test the admin pages after each batch.
When the problem plugin is isolated, keep it off until you repair or replace it. If the site breaks only when a pair of plugins are active together, you may need to choose one or adjust settings so their scripts don’t clash.
Repair The Plugin Files And Server Fit
Once the plugin is disabled, you can fix the root issue without fighting the broken screen. Most fixes fall into clean reinstall, version match, or file permission cleanup.
Reinstall The Plugin Cleanly
Failed updates can leave a plugin half-copied. A clean reinstall replaces missing files and resets the plugin’s code without touching most stored settings.
- Download a fresh copy — Get the plugin zip from a trusted source.
- Delete the broken folder — Remove the plugin directory under wp-content/plugins.
- Install from wp-admin — Upload the zip in Plugins → Add New, then activate it.
- Test the settings page — Open the plugin page that used to fail.
Match PHP And WordPress Versions To The Plugin
Some plugins require a newer PHP build or a newer WordPress core. If the log shows undefined functions or typed features that your PHP build can’t parse, the plugin won’t load.
- Check the plugin’s requirements — Read the plugin page for its PHP and WordPress minimums.
- Update PHP in hosting — Switch to a current PHP version, then retest the plugin screen.
- Update WordPress core — Run core updates before reactivating the plugin.
Fix File Ownership And Permissions
Permission errors can block plugin reads or prevent WordPress from writing temporary update files. If your log shows “Permission denied,” fix it before the next update.
- Check wp-content access — Confirm the web server user can read plugin files and write to wp-content.
- Confirm free disk space — Low space can interrupt updates and leave broken folders.
- Remove stale cache layers — Clear caching and minify plugins after you restore the plugin.
Keep The Error From Returning
After the plugin loads again, spend a few minutes tightening the routine that keeps admin pages stable. This helps avoid repeating the same “an error was encountered while trying to load this plugin” loop after the next update.
- Update in a staging copy — Apply plugin updates on a staging site first, then repeat on live once it looks clean.
- Keep a recent backup — A one-click restore is faster than manual recovery when an update goes wrong.
- Limit admin script conflicts — If you run minify or combine scripts, exclude wp-admin and plugin pages from aggressive settings.
- Watch Site Health — Check Tools → Site Health after hosting changes, PHP switches, or large plugin updates.
- Review logs weekly — A quick scan catches fatal errors before they pile up into broken screens.
If you keep seeing the same fatal line after a clean reinstall and version checks, the plugin may have a real bug on your setup. In that case, stick with the last working version or replace it with a plugin that handles the same job without breaking wp-admin.
