Guides April 9, 2026

WordPress Plugin Suddenly Not Working? Check Your PHP Version

Why Your WordPress Plugin Stopped Working: Check Your PHP Version

Plugins expand WordPress, adding features. But what if a plugin stops working? Don’t worry! The problem is often a mismatch between the plugin’s PHP version requirement and your server’s PHP version.

A plugin built for PHP 8.0+ might struggle on PHP 7.4. Here’s how to diagnose and fix this issue.

Signs of a PHP Version Problem

How can you tell if a PHP version issue is causing your plugin problems? Watch for these indicators:

Finding Your PHP Version

First, determine the PHP version your WordPress site uses. Here’s how:

  1. WordPress Site Health: Go to Tools > Site Health in your WordPress dashboard. Find the “Server” section; it lists your PHP version.
  2. Hosting Control Panel: Log in to your hosting account (e.g., cPanel, Plesk). Look for PHP settings to view and change the version.
  3. Ask Your Host: If unsure, contact your hosting provider’s support. They can quickly tell you your PHP version.

Confirm Plugin Compatibility

Next, confirm that the plugin causing issues is compatible with your PHP version. Here’s how to check:

Adjusting Your PHP Version

If your PHP version and the plugin’s requirements are incompatible, adjust your PHP version. Always back up your site before making changes!

Important: After changing your PHP version, clear your browser cache and any WordPress caching plugins.

Other Causes and Solutions

If the PHP version is correct, yet your plugin still malfunctions, try these troubleshooting steps:

Still Stuck? Enable Debug Mode

For more specific error details, turn on WordPress debug mode. Add these lines to your wp-config.php file:


define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

This action will record errors to a wp-content/debug.log file. Review this file for clues about what’s going wrong.

By systematically checking your PHP version and working through these steps, you can often restore your WordPress plugins and keep your site running.

Back Up Your Site Before Troubleshooting

Before attempting any fixes, create a full copy of your WordPress website. Consider this your safety net.

Why is a backup so vital?

What should you include in the backup?

  1. WordPress Files: Include all files in your WordPress directory (wp-content, wp-includes, etc.).
  2. Database: Include your WordPress database, which holds your posts, pages, and settings.

How do you create a backup?

Store your backups in a separate location from your web server, such as cloud storage or an external hard drive. This protects your backups if the server fails.

With a current backup ready, you can address plugin issues with confidence, knowing your site is protected from damage.

Checking and Updating Your PHP Version

A frequent cause of plugin problems is an outdated PHP version. WordPress and its plugins require a specific PHP version to function correctly.

Let’s determine your current PHP version and update it if necessary.

The Importance of PHP Version

PHP acts as the engine for your WordPress site. Like any engine, it requires updates to run efficiently and support current software, like your plugins.

An old PHP version can cause plugin incompatibility, security vulnerabilities, and slower website performance.

Finding Your Current PHP Version

Here are a few ways to determine your current PHP version:

  1. WordPress Site Health Tool: Go to Tools > Site Health in your WordPress dashboard. Find the “Server” section.
  2. Hosting Account: Log in to your hosting control panel (like cPanel or Plesk). Look for a PHP settings area.
  3. Contact Your Host: If you’re unsure, your hosting provider can quickly tell you your PHP version.

The Site Health tool is the simplest method for most users.

Recommended PHP Versions for WordPress

WordPress suggests using PHP 7.4 or higher as of late 2024. Versions 8.0 and above offer faster performance.

Here’s a quick guide to PHP compatibility:

PHP Version Status
7.4 or Higher Recommended
7.3 or Lower Outdated (Upgrade!)

Always confirm a plugin’s specific PHP needs by checking its documentation.

Updating PHP and What to Do If You Can’t

If your PHP version is outdated, here’s how to update it:

  1. Log in to your hosting control panel.
  2. Find the PHP settings section. This might be labeled “PHP Version Manager,” “PHP Selector,” or something similar.
  3. Select a newer PHP version (7.4 or higher).
  4. Save your changes.

The exact steps depend on your hosting provider. If you need assistance, reach out to their support team.

Important: Back up your site before changing your PHP version. Though uncommon, updates can sometimes lead to compatibility problems.

What if your hosting provider doesn’t offer a newer PHP version? Then consider switching to a better host. An outdated PHP version creates security vulnerabilities. It also restricts your ability to use current WordPress features and plugins.

Keeping your WordPress site secure and fast requires updating your PHP version. It also ensures compatibility with your plugins.

Finding Your Current PHP Version

The first step in fixing plugin issues involves checking your PHP version. Here’s how:

The Site Health tool offers a quick and easy method.

Note your PHP version. You’ll need it to verify plugin compatibility.

Updating Your PHP Version

Is your PHP version out of date? Then it’s time to upgrade. Most hosting providers simplify this process.

Here’s the general process:

  1. Log in to your hosting control panel. This is typically cPanel, Plesk, or a custom dashboard from your host.
  2. Find the PHP configuration section. Look for “PHP Settings,” “PHP Version Manager,” or “MultiPHP Manager.” The name may vary.
  3. Select a compatible PHP version. Pick a version that meets the plugin’s requirements and remains stable. WordPress often suggests a specific version. Aim for that or the latest stable release.
  4. Save the changes. Apply the new PHP version to your website.

Important Considerations:

What if you can’t locate the PHP settings?

Contact your hosting provider’s support team. They can walk you through the process or update the PHP version for you.

After updating, clear your browser cache and any WordPress caching plugins. Then, check your site to see if the plugin issue disappeared.

If the problem continues, try other troubleshooting steps.

Enable Debug Mode to Uncover Errors

Still scratching your head? WordPress debug mode is a useful tool. It reveals hidden errors that can pinpoint plugin problems.

It’s like a doctor using an X-ray. Debug mode shows what’s happening under the surface, exposing issues you might otherwise miss.

How Debug Mode Works

Debug mode displays PHP errors, warnings, and notices. These messages often explain what’s going wrong with your plugin.

Without debug mode, these errors are often hidden. You’re left guessing about the cause of the problem.

Enabling Debug Mode and Locating the Debug Log

To diagnose plugin issues, turn on WordPress debug mode. You’ll need to edit your wp-config.php file, which sits in the root directory of your WordPress installation.

Important: Back up your wp-config.php file before making changes!

  1. Access your server: Use FTP or your hosting provider’s file manager.
  2. Locate wp-config.php: It’s usually in the same directory as wp-admin and wp-content.
  3. Edit the file: Open wp-config.php in a text editor.
  4. Add the following lines: 
    
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
  5. Save the file: Upload the modified wp-config.php back to your server.

Those lines perform specific actions:

The debug.log file contains the error messages you need. You’ll find it within the wp-content directory.

Understanding Error Messages

Error messages might seem intimidating, but they usually offer helpful information.

Pay attention to these details:

Copy and paste the error message into a search engine. You can often find answers or clarifications.

Turn Off Debugging After Troubleshooting

After you identify the source of the problem, turn off debugging. Keeping it on could show private details to visitors.

To turn off debugging, change true to false in the wp-config.php file:


define( 'WP_DEBUG', false );

Debugging is a useful way to troubleshoot WordPress plugin issues. Use it carefully.

How to Enable Debug Mode

WordPress debug mode can be helpful when plugins misbehave. It reveals hidden errors, offering clues for fixing the problem.

Consider it a peek behind the curtain of your website’s operation.

To activate it:

  1. Access your server. Use FTP or your hosting provider’s file manager.
  2. Find wp-config.php. It’s in your WordPress root directory.
  3. Edit wp-config.php. Open it with a text editor.
  4. Add this line:
    define( 'WP_DEBUG', true );
  5. Save the file. Upload it back to your server.

Now, WordPress will display PHP errors on your site.

Important: These errors are visible to all visitors. Only enable debug mode on a staging site or when you’re the only one viewing the live site.

To save errors to a file instead of showing them on the screen, add these lines:


define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

This saves errors to a debug.log file in your wp-content directory.

Remember to turn off debug mode after troubleshooting. Change true to false in the wp-config.php file.

Debug mode is a useful feature, so use it carefully!

Examine Error Messages for Plugin Issues

With debug mode on, search for clues. Go to the page on your website where the plugin isn’t working.

Watch for any error messages. They can point you to the source of the problem.

Identifying Common Errors

Here’s an example of a plugin-related error:


Warning: Undefined variable $my_variable in /home/your-site/wp-content/plugins/my-plugin/my-plugin.php on line 25

In this example, the error occurs in the my-plugin.php file of the my-plugin plugin, on line 25.

Finding Hidden Errors

If errors aren’t showing on the page, examine your server’s error logs. Your hosting provider can assist in locating them.

The error log records all PHP errors on your site. It provides a detailed account of issues.

Understanding Error Information

After pinpointing the problematic plugin and the specific error, consider these steps:

  1. Search Online: Copy the error message into a search engine. Others may have faced the same issue and discovered a fix.
  2. Contact the Plugin Developer: Get in touch with the plugin’s creator for assistance. Share the error message and details about your WordPress setup.
  3. Examine the Code: If you know PHP, you could attempt to correct the error. Proceed with caution.

Turn off debug mode once you’re done troubleshooting.

Deactivate and Reactivate Plugins

A basic reset can often work. Turning a plugin off and then on again can fix small issues and remove short-term conflicts.

Think of it as rebooting your computer. It’s a fast, simple solution before more involved troubleshooting.

Deactivating and Reactivating Plugins

Deactivating and reactivating a plugin can resolve issues by:

This is a low-risk, high-reward step. Try it early in your troubleshooting process.

Here’s how to deactivate and reactivate a WordPress plugin:

  1. Go to Plugins > Installed Plugins in your WordPress dashboard.
  2. Find the plugin causing problems in the list.
  3. Click the Deactivate link below the plugin’s name.
  4. After deactivation, the Activate link will appear. Click it.

The process is straightforward.

After Reactivation

Once you reactivate the plugin:

If the problem remains, other solutions may be needed.

Reactivation can be surprisingly effective.

Deactivate All Plugins to Isolate Issues

If you can’t pinpoint the cause, try turning off all plugins. This can help identify conflicts.

Consider this a process of elimination. Deactivate everything, then reactivate each plugin individually.

Resolving Plugin Conflicts

Plugins sometimes clash, where one plugin’s code interferes with another, leading to unexpected behavior.

Deactivating all plugins creates a clean slate. This allows you to isolate the source of the problem.

Deactivating Plugins in WordPress

  1. Go to Plugins > Installed Plugins in your WordPress dashboard.
  2. Select all plugins using the checkbox at the top of the list.
  3. In the “Bulk actions” dropdown, choose “Deactivate.”
  4. Click “Apply.”

With these steps, all your plugins should be deactivated.

Reactivating Plugins to Isolate the Problem

Reactivate your plugins individually to find the source of the issue.

  1. Activate the first plugin on your list.
  2. Check your website to see if the problem returns.
  3. If the issue remains absent, activate the next plugin.
  4. Continue this process until the error reappears.

The plugin activated just before the problem returned is the likely cause.

Resolving Plugin Conflicts

After pinpointing the conflicting plugin:

Deactivating and reactivating each plugin provides a methodical way to uncover conflicts. This process requires patience, but it often proves the most dependable.

Check for Theme Conflicts

A WordPress theme, while less likely than a plugin, can still cause problems.

Consider the theme the framework of your website. A poorly constructed framework interferes with plugin function.

Reasons for Theme Conflicts

Themes conflict with plugins for several reasons.

Troubleshooting with Theme Switching

The simplest test for plugin issues involves temporarily switching to a default WordPress theme.

WordPress includes several default themes, such as Twenty Twenty-Three and Twenty Twenty-Two.

Steps to Change Your Theme

  1. Go to Appearance > Themes in your WordPress dashboard.
  2. Find a default WordPress theme (e.g., Twenty Twenty-Three).
  3. Click the Activate button.

Your website will now use the default theme. If the plugin functions correctly with a default theme active, the issue likely stems from a conflict with your previous theme.

Test the Plugin After Switching Themes

Once you’ve switched themes, test the plugin that was causing problems. Does the plugin now work correctly? Are the errors gone?

If the plugin works with the default theme, the issue is likely within your original theme. Here’s how to address it:

If the Plugin Still Doesn’t Work

If the plugin malfunctions even with the default theme activated, the issue probably isn’t your theme.

Explore other troubleshooting steps. Examine your PHP version or try deactivating other plugins.

Checking for theme conflicts is a straightforward but vital step when diagnosing plugin problems. Don’t skip it!

Reinstalling the Plugin

Corrupted plugin files sometimes cause unexpected errors. Deleting and reinstalling the plugin guarantees a fresh set of files.

Consider this a clean start for the plugin. This simple action often fixes persistent problems.

Why Reinstall a Plugin?

Reinstalling replaces all the plugin files with fresh, uncorrupted versions. This often resolves issues stemming from faulty or incomplete installations.

Reinstalling Your Plugin: A Step-by-Step Guide

  1. Deactivate the Plugin: Go to Plugins > Installed Plugins, find the plugin, and click “Deactivate.”
  2. Delete the Plugin: After deactivating, the “Delete” link will appear. Click it to remove the plugin from your server.
  3. Download the Plugin: Download the latest version of the plugin from the WordPress repository (wordpress.org) or the developer’s website.
  4. Install the Plugin: Go to Plugins > Add New, click “Upload Plugin,” and select the ZIP file you downloaded.
  5. Activate the Plugin: After installation, click “Activate Plugin.”

Deleting the plugin will remove its files. Note that it might not remove its settings from the database. Some plugins offer an option to completely remove all data during uninstallation.

After Reinstallation

Once you reinstall the plugin:

If this fixes the problem, great! If not, continue troubleshooting.

Reinstalling quickly eliminates corrupted files as a potential cause.

Downgrading the Plugin

Did the plugin stop working right after an update? The latest version could be the source of the issue. Returning to an earlier, reliable version often resolves the problem.

Updates sometimes contain bugs or compatibility problems that didn’t exist before.

Reasons to Downgrade a Plugin

Sometimes, a plugin update introduces problems. New bugs can appear. The updated plugin might clash with your theme or other plugins. Perhaps the update removed or altered a feature you used regularly.

Downgrading Your Plugin

Here are a couple of ways to revert to an earlier plugin version:

  1. Manual Downgrade (If Available):
    • Check the plugin developer’s website. They might offer downloads of older versions.
    • If you find an older version, download it.
    • Deactivate and delete the current plugin from your WordPress site.
    • Upload and install the older version you downloaded.
  2. Using a Plugin (Recommended):
    • Install a plugin like “WP Rollback.”
    • Go to the plugin’s page in your WordPress dashboard.
    • Click the “Rollback” button.
    • Choose a previous version from the list.
    • Follow the prompts to downgrade the plugin.

The WP Rollback plugin makes the process much easier. It handles the technical aspects of finding and installing older versions.

Important Considerations

After downgrading, test the plugin thoroughly. Make sure it’s working as expected.

Downgrading provides a short-term fix. Watch for updates from the plugin developer that resolve the problems you’re seeing.

Examine WordPress Settings

Sometimes the simplest solutions work best. Incorrect WordPress settings can disrupt plugin operations.

Double-check those settings. Eliminate any misconfigurations as the cause.

Confirm Your Website Address

A frequent cause of plugin malfunctions is an incorrect site URL. Plugins might not work correctly if your WordPress address and site address don’t align with your actual website URL.

To verify your URLs:

  1. Navigate to Settings > General in your WordPress dashboard.
  2. Examine the “WordPress Address (URL)” and “Site Address (URL)” fields.
  3. Confirm that both URLs are accurate and correspond to your website’s address, including https:// if you’re using SSL.

Correct any inaccurate URLs, then save your adjustments.

Set the Correct Timezone

Plugins that depend on scheduling or time-related features can be impacted by an incorrect timezone.

To check your timezone:

  1. Go to Settings > General in your WordPress dashboard.
  2. Locate the “Timezone” setting.
  3. Choose the appropriate timezone for your area.
  4. Save your adjustments.

Reviewing General Settings

The General Settings screen contains several options worth a quick look:

These settings might not directly cause plugin malfunctions. Still, verifying their accuracy is a good practice.

WordPress plugins frequently use these basic settings. When settings are off, several problems can arise:

Checking these WordPress settings quickly eliminates simple configuration errors. Consider it a first step before more complex troubleshooting.

Get Expert Assistance

Still struggling? Don’t despair! Sometimes, the best solution is to seek expert help. If you’ve tried all the troubleshooting steps above, contact the plugin developer or the WordPress community.

Contacting the Plugin Developer

The plugin developer knows their plugin best. They can offer specific advice and might already know about the issue.

Here’s how to reach them:

When you contact the developer, provide:

The more details you give, the better they can help.

Seeking Assistance

The WordPress community is large and supportive. If the plugin developer doesn’t respond, turn to the WordPress support forums.

Here’s how to get started:

  1. Visit the WordPress.org Forums: Go to wordpress.org/support/.
  2. Search for Existing Topics: First, search the forums. See if others have faced the same problem.
  3. Create a New Topic: If no solution exists, start a new thread. Describe the issue in detail.

When posting, remember to:

When to Hire a WordPress Expert

If troubleshooting feels daunting, or if time is of the essence, think about hiring a WordPress expert.

You can find one in these places:

Engaging a professional can be a smart move for complicated or pressing problems.

You have options. The WordPress community stands ready to assist. Don’t hesitate to ask for help when needed.

How SEOS7 Can Help Fix Plugin Issues

A healthy, functioning website is the bedrock of successful SEO. If WordPress plugins are causing chaos, SEO efforts will suffer.

SEOS7 specializes in SEO automation, and we know a stable website matters. We offer tools to diagnose and improve your site.

AI-Driven SEO Site Audits

Our platform uses AI to conduct thorough SEO health checks. These checks pinpoint issues that might affect plugin performance.

Here’s how SEOS7 assists:

A healthy website is key for effective SEO. SEOS7 gives you the tools to keep your WordPress site running smoothly and performing well.

References

  1. www.godaddy.com › help › troubleshoot wordpress plugin errors 26340
  2. wordpress.org › support › topic › plugin suddenly stopped working 22

Relevant Articles

← Previous The Developer's Guide to Debugging WordPress Plugin Issues
Next → How to Read WordPress Error Logs to Fix Plugin Problems
Automate Your Website SEO — Let SEOS7 handle audits, fixes & monitoring on autopilot. Get Started