Guides April 11, 2026

Fixing a WordPress Plugin That’s Causing the White Screen of Death

Understanding the WordPress White Screen of Death (WSOD)

Does your WordPress site display a blank white screen? This frustrating issue is the White Screen of Death (WSOD), but it’s often fixable, so don’t panic.

The WSOD makes your website inaccessible. Visitors see nothing, and you cannot log in to the admin area. The site seems to vanish.

What causes this problem?

Identifying the cause is key. Let’s begin!

Before you start: Back up your website. This creates a safety net if something goes wrong during troubleshooting. Most hosting providers provide backup options. Use them.

Here’s a preparation checklist:

  1. Back up your site: Seriously, do this first.
  2. Disable caching plugins: These can obscure errors.
  3. Turn off WP_CACHE: If enabled, disable it temporarily.

Now, let’s begin troubleshooting.

Preparing Your WordPress Site for Troubleshooting

Before fixing anything, prepare your WordPress site for troubleshooting. This is like wearing safety gear before repairs. It protects your site and makes the process easier.

Why is preparation vital?

Back Up Your Website

This step is critical. Think of a backup as your safety net. Should something go wrong while you’re troubleshooting, you can revert your site to its original condition.

Here’s how to back up your site:

Important: Keep your backup in a secure location, separate from your website’s server.

Disable Caching Plugins

Caching plugins save static versions of your webpages, speeding up load times. While this is beneficial for site performance, these plugins can mask errors when you’re trying to diagnose problems.

To disable caching plugins:

  1. Log in to your WordPress dashboard.
  2. Go to “Plugins” > “Installed Plugins.”
  3. Locate your caching plugin (for example, WP Super Cache or W3 Total Cache).
  4. Click “Deactivate.”

Disable WP_CACHE

WP_CACHE is a WordPress function that enables code-level caching. If active, disable it temporarily for troubleshooting.

To disable WP_CACHE:

  1. Access your wp-config.php file using FTP or your hosting control panel’s file manager.
  2. Locate the line define('WP_CACHE', true);
  3. Change true to false: define('WP_CACHE', false);
  4. Save the file.

With these steps, your WordPress site is ready for troubleshooting. Now you can focus on identifying the source of the white screen.

Back Up Your WordPress Site

Before troubleshooting, create a backup of your WordPress site. This provides a safety net, allowing you to restore your site if problems arise.

Think of a backup as a “restore point” for your website. It captures your site’s current state, hopefully a functional one.

You can create this safety net using these methods:

Here’s a closer look at each option:

  1. Using a Plugin: Install a backup plugin from the WordPress plugin directory. Follow the plugin’s instructions to create a complete backup. Store the backup files in a secure location, such as a cloud storage service.
  2. Checking Your Hosting Provider: Log in to your hosting account and look for a “Backups” section. Then, create a backup using their interface.
  3. Manual Backup (Advanced):
    1. Use FTP to download all your WordPress files to your computer.
    2. Use phpMyAdmin (usually in your hosting control panel) to export your WordPress database.

Important: Do not skip this step. A backup can prevent significant frustration.

Disable Caching Plugins and WP_CACHE

Caching improves site speed. However, it can hide the real issues when you’re troubleshooting. Caching plugins and the WP_CACHE constant save older versions of your site. You might not see the errors causing the White Screen of Death.

Deactivating caching ensures you view the newest version of your site. This helps pinpoint the source of the problem.

Here’s how to deactivate caching:

Disable Caching Plugins

  1. Log in to your WordPress dashboard.
  2. Go to Plugins > Installed Plugins.
  3. Find your caching plugin (like WP Super Cache, W3 Total Cache, or similar).
  4. Click Deactivate under the plugin’s name.

Disable WP_CACHE

The WP_CACHE constant exists in your wp-config.php file. Access this file through FTP or your hosting provider’s file manager.

  1. Connect to your server using FTP or your hosting file manager.
  2. Locate the wp-config.php file in your WordPress root directory.
  3. Open the file for editing.
  4. Look for the line define('WP_CACHE', true);
  5. Change true to false: define('WP_CACHE', false);
  6. Save the wp-config.php file.

Deactivating caching means you see the most current iteration of your site. This is vital for accurate troubleshooting.

Find the Plugin Behind the White Screen of Death

Ready to find the troublemaker? See if a plugin triggers the White Screen of Death. We’ll use WordPress’s built-in debug mode and a process of elimination.

Finding the Faulty Plugin

Debug mode displays PHP errors. These errors can identify the plugin causing the issue. The process isn’t complicated.

  1. Access your wp-config.php file using FTP or your hosting file manager.
  2. Add these lines to the file:
    define( 'WP_DEBUG', true );
    define( 'WP_DEBUG_DISPLAY', true );
    define( 'WP_DEBUG_LOG', true );
  3. Save the file, then visit your website.
  4. Examine the page for error messages.

Errors that mention a specific plugin are a strong indication of the source.

If no errors appear, or for a more complete test, disable all plugins to isolate the source of the problem.

Here’s how to deactivate plugins:

  1. If you can reach your WordPress dashboard, navigate to Plugins > Installed Plugins.
  2. Select all plugins.
  3. From the “Bulk actions” menu, choose “Deactivate”.
  4. Click “Apply.”

If you cannot access your dashboard:

  1. Use FTP or your hosting file manager to open the wp-content/plugins folder.
  2. Change the name of the plugins folder to something like plugins_old. This will deactivate every plugin.

Then, check your website. If the White Screen of Death disappears, a plugin is the cause.

Reactivating Plugins to Identify the Culprit

Detective work begins now. Reactivate your plugins individually. After each activation, check your website. The moment the White Screen of Death (WSOD) reappears, you’ve located the source of the problem.

Follow this process:

  1. If you renamed the plugins folder, rename it to its original name: plugins.
  2. In your WordPress dashboard (Plugins > Installed Plugins), activate a single plugin.
  3. Check your website to see if the WSOD appears.
  4. Repeat steps 2 and 3 until the WSOD returns.

When the WSOD returns, the last plugin you activated is probably the cause. Note which plugin triggered the error!

Resolving Issues with the Problematic Plugin

You’ve found the plugin creating the problem. What should you do next?

These steps will help you pinpoint the plugin causing the White Screen of Death. You can then take appropriate measures to fix the problem.

Enable WordPress Debug Mode

WordPress debug mode displays PHP errors on your site. These errors can offer insights into the cause of the White Screen of Death (WSOD).

Consider it a diagnostic tool that reveals your site’s inner workings, pointing out any code-related issues.

To enable it:

  1. Access your wp-config.php file via FTP or your hosting control panel’s file manager.
  2. Open the wp-config.php file for editing.
  3. Add these lines of code *before* the line that says /* That's all, stop editing! Happy publishing. */:
    define( 'WP_DEBUG', true );
    define( 'WP_DEBUG_DISPLAY', true );
    define( 'WP_DEBUG_LOG', true );
  4. Save the wp-config.php file.

Here’s what each line does:

Visit your website. Error messages should appear on the screen. These messages can help you pinpoint the problematic plugin or theme.

Important: After troubleshooting, disable debug mode by changing true to false in the wp-config.php file. Leaving debug mode active could expose sensitive information to visitors.

To disable it:

  1. Access your wp-config.php file again.
  2. Change the lines to:
    define( 'WP_DEBUG', false );
    define( 'WP_DEBUG_DISPLAY', false );
    define( 'WP_DEBUG_LOG', false );
  3. Save the file.

By activating and carefully reviewing the debug output, you’re taking a key step toward diagnosing and fixing the White Screen of Death.

Checking WordPress Error Logs

Sometimes, errors aren’t visible on your website. That’s where error logs prove useful. They offer a detailed record of what’s happening behind the scenes.

Error logs record PHP errors and other issues that might be causing the “MY WORDPRESS PLUGIN ISN’T WORKING” problem. They can be considered clues for solving the issue.

To find them:

  1. Log in to your hosting provider’s control panel (like cPanel or Plesk).
  2. Find a section labeled “Logs,” “Error Logs,” or something similar. The name depends on your host.
  3. Open the error log file, usually named error_log or something similar.

What to look for in the error log:

Here’s an example of an error message:

PHP Fatal error:  Call to undefined function some_function() in /wp-content/plugins/my-plugin/my-plugin.php on line 20

In this example, the error is in my-plugin.php on line 20. This indicates that the “MY WORDPRESS PLUGIN ISN’T WORKING” problem likely relates to “my-plugin”.

If you find errors related to a specific plugin, try these steps:

  1. Deactivate the plugin.
  2. Check for updates to the plugin.
  3. Contact the plugin developer for support.

Error logs might seem intimidating, but they’re a useful tool for diagnosing WordPress issues. Take your time, read the messages carefully, and you’ll be closer to fixing your site.

Isolating the Problem Plugin

Deactivate Plugins to Diagnose the Error

If you can’t determine the source of the problem, deactivate all plugins. This step helps you discover if a plugin conflict triggers the “MY WORDPRESS PLUGIN ISN’T WORKING” error.

Consider this a process of elimination. Disabling all plugins temporarily allows you to see if the White Screen of Death disappears. If it does, a plugin is at fault.

Accessing the Dashboard

  1. Go to Plugins > Installed Plugins.
  2. Select all plugins by checking the box at the top of the list.
  3. In the “Bulk actions” dropdown, choose “Deactivate”.
  4. Click “Apply”.

No Dashboard Access

You can still deactivate plugins using FTP or your hosting provider’s File Manager.

  1. Connect to your server using FTP or File Manager.
  2. Go to the wp-content folder.
  3. Rename the plugins folder to something like plugins_deactivated. This action disables all plugins.

Important: Renaming the plugins folder deactivates every plugin simultaneously. If you regain site access, rename the folder back to plugins to view your plugins again.

After deactivating all plugins, check your website. If the White Screen of Death disappears, a plugin caused the problem. Now, reactivate plugins individually to find the specific troublemaker.

Reactivate Plugins to Find the Culprit

With all plugins deactivated, you can now identify the one causing the “MY WORDPRESS PLUGIN ISN’T WORKING” issue by reactivating them individually.

This isolates the problematic plugin. The process can be slow, but it’s the most reliable identification method.

Follow these steps to reactivate plugins one by one:

  1. If you renamed the plugins folder, rename it back to plugins. This makes your plugins visible in the WordPress dashboard.
  2. Log in to your WordPress dashboard.
  3. Go to Plugins > Installed Plugins.
  4. Activate the *first* plugin on the list.
  5. Visit your website and check if the White Screen of Death (WSOD) reappears.
  6. If the WSOD *hasn’t* reappeared, return to the Plugins page and activate the *next* plugin.
  7. Repeat steps 5 and 6, activating one plugin at a time, checking your website after each activation.
  8. When the WSOD *does* reappear, the *last* plugin you activated likely caused it.

Important: Track the plugins you’ve activated to maintain your place in the process.

Once you find the problematic plugin:

By carefully reactivating your plugins one by one, you can pinpoint the specific plugin causing the “MY WORDPRESS PLUGIN ISN’T WORKING” error and take steps toward a solution.

Fixing or Replacing the Problematic Plugin

You’ve identified the plugin causing the white screen of death. Excellent! Now, let’s get your site working again.

You have a few choices:

Update the Plugin

First, see if the plugin has a newer version. Plugin creators frequently release updates to correct errors and improve compatibility.

Here’s how to update a plugin:

  1. Go to Plugins > Installed Plugins in your WordPress dashboard.
  2. Find the plugin causing problems. Look for a notice that says an update is available.
  3. Click “Update Now.”

After the update finishes, check your website. Did that fix the problem? If not, try something else.

Contacting the Plugin Developer

If updating the plugin doesn’t solve the problem, get in touch with the developer. They might know about the issue and have a fix or a temporary solution.

Here’s how to reach out:

Remember to be patient. The more information you provide, the easier it will be for the developer to understand the issue.

Finding a Replacement Plugin

If the plugin remains broken, or if the developer doesn’t provide sufficient support, think about using a different plugin. Many plugins provide similar features.

Keep these points in mind when selecting a replacement:

Before installing a new plugin, turn off and remove the one that’s causing problems. This avoids potential conflicts.

Here’s how to find a new plugin:

  1. Go to Plugins > Add New in your WordPress dashboard.
  2. Search for plugins that do the same thing as the broken one.
  3. Look at reviews and check if it’s compatible before installing.

Careful consideration of these options can fix the “MY WORDPRESS PLUGIN ISN’T WORKING” issue and restore your WordPress site.

Update or Get Support for the Plugin

First, update the plugin. Developers frequently fix bugs and improve compatibility through updates.

To update, follow these steps:

  1. Go to Plugins > Installed Plugins in your WordPress dashboard.
  2. Find the plugin causing problems. Look for an “Update Available” message.
  3. Click Update Now.

Did the update solve the problem? Excellent! If not, continue to the next troubleshooting step.

If issues persist, contact the plugin developer. They have intimate knowledge of their code and can provide specific guidance.

You can typically find their contact information in these places:

When you contact the developer, be clear and concise. Provide these details to help them understand the issue:

  1. Plugin Version: Specify the version of the plugin you’re using.
  2. WordPress Version: Mention your WordPress version.
  3. PHP Version: Include your PHP version (you can find this in Site Health).
  4. Error Messages: Copy and paste any error messages you’re seeing.
  5. Steps to Reproduce: Explain the actions that trigger the problem.

Here’s an example message:

Subject: Plugin [Plugin Name] – White Screen of Death Error

Hi [Developer Name],

I’m experiencing a White Screen of Death after activating your plugin, version [Plugin Version]. My site runs WordPress [WordPress Version] and PHP [PHP Version].

The error message I’m seeing is: [Error Message]

This happens when I [Steps to Reproduce].

Could you please help me resolve this issue?

Thanks,

[Your Name]

Remember to be patient. Developers are often busy. Most will respond within a few days. Detailed information helps them diagnose and resolve the problem more quickly.

Replace the Plugin

Sometimes a plugin simply won’t work, despite your best efforts. If updating and contacting the developer prove fruitless, consider finding a substitute.

Think of it this way: if a tool constantly breaks, a more reliable one is needed.

Here’s how to find a good alternative:

  1. Identify the plugin’s core function: What does the problematic plugin do? List its key features.
  2. Search the WordPress plugin directory: Use keywords related to the plugin’s function to find alternatives.
  3. Evaluate potential replacements: Consider these factors:
    • Features: Does it offer the features you need?
    • Reviews: What do other users say about its performance and reliability?
    • Active installations: A high number of active installations often suggests a well-maintained plugin.
    • Last updated: Is the plugin actively maintained and recently updated?
    • Compatibility: Is it compatible with your version of WordPress?
  4. Install and test: If possible, first install the new plugin on a staging site to ensure it works with your theme and other plugins.
  5. Deactivate and delete the old plugin: Once satisfied with the replacement, deactivate and delete the problematic plugin to avoid conflicts.

Before deleting the old plugin, transfer any necessary data or settings to the new plugin. Some plugins offer import/export features to simplify this process.

Choosing a dependable plugin is important for your website’s stability and function. Take your time, research, and select an alternative that fits your needs.

Using the Health Check & Troubleshooting Plugin

The Health Check & Troubleshooting plugin can be helpful when problems arise. It helps diagnose and resolve issues on your WordPress site.

Created by the WordPress.org community, this plugin has several useful features.

Installing and Using the Health Check & Troubleshooting Plugin

  1. Go to Plugins > Add New in your WordPress dashboard.
  2. Search for “Health Check & Troubleshooting”.
  3. Click Install Now and then Activate.

The Health Check & Troubleshooting plugin helps identify plugin conflicts. Its troubleshooting mode deactivates all plugins and switches to a default theme. This only affects your user session. Site visitors won’t see any changes.

  1. Go to Tools > Site Health.
  2. Click on the Troubleshooting tab.
  3. Click the Enable Troubleshooting Mode button.

Your site now runs solely on WordPress core files. If the White Screen of Death disappears, a plugin or theme caused the error.

Reactivating Plugins in Troubleshooting Mode

To pinpoint the problematic plugin, turn your plugins back on individually while in Troubleshooting Mode. After each activation, check your site for the white screen.

  1. Go to Plugins > Installed Plugins.
  2. Click the Activate link under each plugin, one at a time.
  3. After activating each plugin, visit your website to see if the WSOD reappears.

If the white screen returns, the last plugin you activated likely caused it. Turn that plugin off. Then, consider updating it, contacting the developer, or finding a replacement.

The Health Check & Troubleshooting plugin offers a secure way to diagnose and fix plugin conflicts. It aims to return your WordPress site to normal quickly.

Run Site Diagnostics

The Health Check & Troubleshooting plugin scans your WordPress setup for common problems. Consider it a check-up for your website, pointing out potential trouble before it escalates.

Here’s how to run the diagnostics:

  1. Go to Tools > Site Health in your WordPress dashboard.
  2. Review the Status tab. This shows an overview of your site’s health.
  3. Pay attention to the Critical issues and Recommended improvements sections.

The plugin looks for issues like these:

Each issue includes a description and often a suggestion for fixing it. For example, it might advise updating your PHP version or removing a plugin that’s not active.

Here are some common diagnostic findings:

Issue Possible Cause Recommendation
Outdated PHP version Using an older version of PHP Update to the latest stable PHP version. Contact your hosting provider for assistance.
Inactive plugins Having plugins installed but not activated Remove inactive plugins to improve security and performance.
Missing required modules Your server is missing necessary PHP modules Contact your hosting provider to install the required modules.

Addressing the issues identified in the Site Health check improves your site’s security, performance, and stability. It’s a good first step in fixing any WordPress problem.

Enable Troubleshooting Mode

The Health Check & Troubleshooting plugin includes a helpful “Troubleshooting Mode.” It lets you test your site in a secure environment, without disrupting the experience of visitors. Think of it as a private staging area.

Here’s what this mode does:

This helps pinpoint the source of the “MY WORDPRESS PLUGIN ISN’T WORKING” issue. If the White Screen of Death disappears when Troubleshooting Mode is on, a plugin or theme is the cause.

To enable it:

  1. Go to Tools > Site Health in your WordPress dashboard.
  2. Click on the Troubleshooting tab.
  3. Click the Enable Troubleshooting Mode button.

Once enabled, your dashboard will look slightly different. A notice at the top indicates that Troubleshooting Mode is active.

Now, reactivate your plugins and theme, one at a time, to find the source of the problem.

Here’s the process:

  1. Go to Plugins > Installed Plugins.
  2. Activate each plugin individually. After activating each plugin, check your website to see if the White Screen of Death reappears.
  3. If the WSOD reappears after activating a specific plugin, that’s your troublemaker! Deactivate it.
  4. Repeat the process for your theme. Go to Appearance > Themes and activate a different theme. If the WSOD reappears, your theme is the problem.

Using Troubleshooting Mode, you can quickly and safely identify the plugin or theme causing the “MY WORDPRESS PLUGIN ISN’T WORKING” error. Then you can fix or replace the problematic component.

Maintaining a Healthy WordPress Site

Keeping a WordPress site healthy can feel complex. SEOS7 provides tools to simplify the process and keep your site running well.

The focus is on providing actionable insights to improve your site’s performance and stability. These insights help you address issues proactively.

Features for WordPress Health

Our tools integrate with your existing WordPress setup. You don’t have to overhaul your entire site.

We prioritize a user-friendly experience. SEOS7 is intuitive and easy to use, even without advanced technical skills.

Using SEOS7, you can proactively address problems and maintain your WordPress site’s health.

Automated Site Audits with SEOS7

SEOS7’s Site Audit tool monitors your WordPress website. It scans your site for common SEO problems that can reduce performance and lead to errors.

Consider it a regular check-up for your website’s well-being.

The tool checks for:

The Site Audit tool provides a report of any issues found, with recommendations for fixing them.

SEOS7 also offers AI-powered auto-fixing for common SEO elements:

With SEOS7’s Site Audit and AI-powered fixing, you can keep your WordPress site healthy, optimized, and error-free. This can prevent issues like the White Screen of Death and ensure a good user experience.

Tracking Plugin Actions with Annotations

Do you ever wonder if a plugin update actually helped your site? SEOS7 provides annotations to track plugin actions. You can then observe the direct effect of your changes.

SEOS7 automatically tracks key plugin activities:

These actions are overlaid on your Google Search Console (GSC) performance chart. A visual timeline of your efforts and their results is created.

Here’s how it works:

  1. You update a plugin to patch a security hole.
  2. SEOS7 automatically marks this event on your GSC chart.
  3. Over the next few weeks, you see your site’s traffic and search rankings improve.

The annotation connects the plugin update with the positive outcome. You can better understand what’s working.

With SEOS7’s annotation feature, you can:

Stop guessing and start seeing the real results of your plugin management!

Key Steps to Fixing the White Screen of Death

Repairing a WordPress plugin that’s causing the White Screen of Death can be complex. A systematic approach makes it achievable.

Keep these steps in mind:

At SEOS7, we recognize a healthy WordPress site is vital. Our tools help you proactively find and fix potential issues before they escalate.

We include features such as:

Ready to manage your WordPress site’s health and SEO? Automate Your SEO with SEOS7!

References

  1. www.godaddy.com › help › troubleshoot wordpress plugin errors 26340
  2. learn.wordpress.org › lesson › troubleshooting your site plugin and theme conflicts

Relevant Articles

← Previous WordPress Plugin Support Forums: Your First Stop for Troubleshooting
Next → WordPress Plugin Alternatives: When It's Time to Switch
Automate Your Website SEO — Let SEOS7 handle audits, fixes & monitoring on autopilot. Get Started