You installed a plugin and something broke. Or you updated WordPress and now a feature you rely on has gone quiet. It’s one of the most frustrating things that can happen to your site, especially when you’re not a developer and the error message doesn’t tell you anything useful.

Here’s the thing: most plugin problems come down to a handful of causes, and almost all of them are fixable without deleting anything or starting over. You just need to know where to look.

This guide walks you through exactly that — a step-by-step process for diagnosing and fixing a plugin not working in WordPress. Plus, it’s made specifically for beginners!

Why Is a Plugin Not Working in WordPress?

Before you start troubleshooting, it helps to know what you’re actually looking for. The most common causes of plugin problems are:

• Plugin conflicts — Two plugins are trying to do the same thing, or one is interfering with how another loads
• Theme conflicts — Your theme is overriding something the plugin needs, or loading a different version of a shared file (like jQuery)
• Outdated software — The plugin hasn’t been updated to work with your current version of WordPress or PHP
• Caching — Your site is serving an old cached version and the plugin changes aren’t showing up
• JavaScript errors — A script on your page is throwing an error that stops the plugin from running

The steps below address each of these in order, starting with the most common. If you’re looking to replace a plugin that keeps causing headaches, we’ve also put together a roundup of the best WordPress plugins for photographers worth considering.

Step 1: Check for a Plugin Conflict

Plugin conflicts are the most common reason something stops working, and the first thing to establish is whether any plugin is causing the issue at all. The way to test this is to deactivate all of your plugins at once, check whether the problem disappears, and then reactivate them one by one to narrow down the cause.

Heads up: Deactivating all plugins will temporarily disable features across your site — contact forms, galleries, SEO settings, and anything else powered by a plugin will stop working while you test. This is normal and fully reversible, but try to do it quickly and during low-traffic hours if you can.

Go to Plugins → Installed Plugins in your WordPress admin. Check the box at the very top of the list to select all your plugins at once, then open the Bulk Actions dropdown and choose Deactivate.

Now check whether the problem has disappeared. If it has, you know that plugins are the cause.

The next step is to reactivate them one at a time, checking your site after each one. When the problem returns, the plugin you just activated is the culprit, or it’s conflicting with one that was already active.

You may need to test a few combinations to pinpoint the exact pair. If the problem persists with all plugins deactivated, plugins aren’t the issue — move on to Step 2.

Once you’ve identified which plugin (or pair) is responsible, you have a few options: contact the support team for the conflicting plugins, look for a settings change that resolves the clash, or find an alternative plugin that handles the same job without the conflict.

Step 2: Check for a Theme Conflict

If deactivating all your plugins didn’t make the problem go away, plugins likely aren’t the issue — your theme might be. Some themes load their own versions of shared files — like jQuery — that conflict with what your plugin expects.

Heads up: Switching your theme changes how your site looks to visitors immediately. Your content won’t be affected, but the design will change until you switch back. Do this quickly — confirm the test, then switch back to your original theme right away.

Go to Appearance → Themes and activate one of the default WordPress themes — Twenty Twenty-Five is a good choice, as it ships with WordPress and is known to be conflict-free.

Check whether the plugin now works correctly. If it does, your original theme is likely causing the conflict.

In that case, the best approach is to switch back to it right away, then reach out to your theme’s support team and describe what you found. If the plugin still doesn’t work with the default theme active, the theme isn’t the issue and you can move on to Step 3.

Step 3: Update WordPress, Your Theme, and All Plugins

Outdated software is one of the most overlooked causes of plugin issues. Plugins are built and tested against specific versions of WordPress and PHP — if you’re running an older version of either, some plugins simply won’t work correctly.

There are two scenarios here, and they point in opposite directions:

• If the problem has existed for a while and you haven’t updated recently, outdated software could be the cause. Check for updates under Dashboard → Updates and install anything available. Update WordPress core first, then your theme, then your plugins — checking after each one.
• If the problem started right after an update, the update itself may have introduced the issue. In that case, don’t update further — contact the plugin or theme developer and describe what changed. Some hosts let you roll back to a previous version of a plugin; your developer or host support can help with this.

Either way, check whether the plugin you’re having trouble with has a pending update of its own — sometimes a fix has already been released.

One thing worth knowing: it’s generally safer to update on a staging environment — a private copy of your live site — before pushing changes.

That way, if an update introduces a new problem, your live site stays intact.

Step 4: Check PHP Compatibility

PHP is the programming language that WordPress runs on, and different plugin versions require different versions of PHP. If your hosting environment is running an old or unsupported version of PHP, plugins can fail in ways that look random but are actually very consistent.

WordPress has a built-in tool to check this. Go to Tools → Site Health and look at the Info tab. Scroll down to the Server section — it’ll list your current PHP version. As a general rule, you want to be running PHP 8.1 or higher.

If your PHP version is outdated, you’ll want to upgrade it — but don’t do this without checking first. Jumping to a newer version of PHP can break other plugins that haven’t been updated to support it yet.

Before upgrading, check whether all your active plugins are compatible with the PHP version you’re moving to (usually listed on each plugin’s WordPress.org page under “Requires PHP”). If you’re unsure, ask your host to test the upgrade on a staging environment before applying it to your live site.

Step 5: Clear Your Cache

Caching is great for site performance, but it can make troubleshooting confusing. If your site is serving a cached version of a page, you might think something is broken when really the plugin changes just haven’t shown up yet.

Clear your cache in two places:

• Your caching plugin — If you use WP Rocket, W3 Total Cache, or a similar plugin, find the “Clear Cache” or “Flush Cache” option in its settings and run it.
• Your browser — Hold Shift and click the refresh button (or use Ctrl+Shift+R on Windows / Cmd+Shift+R on Mac) to do a hard reload that bypasses the browser cache.

If your host provides server-level caching (common with managed WordPress hosts like WP Engine or SiteGround), log into your hosting panel and clear the cache there too.

While you’re thinking about performance, our guide to WordPress image optimization covers the other big wins for image-heavy photography sites.

Step 6: Look for JavaScript Errors

A lot of plugin functionality — lightboxes, sliders, gallery interactions, form submissions — runs on JavaScript. If there’s a JavaScript error anywhere on the page, it can silently break everything that runs after it.

To check for JavaScript errors, open your browser’s developer tools. In Chrome or Firefox, right-click anywhere on the page and choose Inspect, then click the Console tab. Any errors show up in red.

Copy the error message and search for it online, or paste it into your support request when you reach out for help. Even if you can’t fix it yourself, this information tells a developer exactly where to look.

Step 7: Deactivate, Delete, and Reinstall the Plugin

If you’ve worked through the steps above and nothing has fixed the issue, the plugin’s files themselves might be corrupted — this can happen during a failed update or an interrupted download. A clean reinstall often sorts it out.

Important: Make sure you have a backup before deleting a plugin. While most plugins store their settings in the WordPress database (meaning they’ll survive a delete-and-reinstall), some plugins are configured to wipe their data on deletion.

Check the plugin’s documentation or support pages to confirm before you proceed.

Go to Plugins → Installed Plugins, find the plugin, and click Deactivate. Once it’s deactivated, click Delete to remove the plugin files from your server.

With the plugin removed, go to Plugins → Add New, search for the plugin by name, reinstall it, and activate it. Check whether the problem is resolved.

If you’re reinstalling a premium plugin, you’ll need to re-upload the zip file from your account rather than searching the WordPress plugin directory.

Step 8: When to Contact Plugin Support

If you’ve worked through all of these steps and the plugin still isn’t behaving, it’s time to reach out to the support team. That’s what they’re there for — and a good support team will help you figure out what’s going on even if the problem turns out not to be their plugin’s fault.

When you contact support, include as much of the following as you can:

• Your WordPress version, PHP version, and theme name
• A list of your active plugins
• The exact error message or behavior you’re seeing
• The steps you’ve already tried
• Whether the problem started after a specific update or change

The more context you provide upfront, the faster they can help you — and the less back-and-forth you’ll need.

FAQs About WordPress Plugin Not Working

Fix It and Get Back to What You Love

A plugin not working in WordPress is annoying, but it’s almost never a dead end. Work through the steps in order — check for conflicts first, then your theme, then software versions — and you’ll find the cause most of the time without needing to delete or reinstall anything.

If you’re still stuck after all of that, reach out to the support team for whichever plugin is giving you trouble. A good support team will work through it with you, and most will help even if the issue turns out to be caused by something else on your site.

Did this help you fix your plugin issue? Let us know in the comments below! For more WordPress tips and photography website help, check out these guides:

• How to Create a Photography Website: Ultimate Beginner’s Guide
• Expert Guide to WordPress Image Optimization – Boost Your Site!
• Best WordPress Plugins for Photographers
• Best WordPress Gallery Plugins to Create Outstanding Visuals
• Photography Website Design: 8 Expert Tips to Stand Out Online

For more photography tips and WordPress tutorials, check out our blog.