Last Updated on
It happens sometimes that our website crashes. The editor stops working or the older posts cannot be updated. The themes customization options don’t respond properly, etc.
To confirm if it’s a bug or if its just a theme/plugin conflict that is causing any of these issues, it is time to perform a quick conflict check on our website by following the instructions below.
Important Note: You can follow these instructions on your live website as well, as running this conflict check does not affect your website visitors.
Theme/Plugin Conflict or Bug Check on Website
Health Check & Troubleshooting
For this purpose, we’ll be using a free WordPress Plugin Health Check & Troubleshooting.
- This plugin will perform a number of checks on your WordPress installation to detect common configuration errors and known issues, and also allows plugins and themes to add their own checks.
- The debug section, which allows you to gather information about your WordPress and server configuration that you may easily share with support representatives for themes, plugins or on the official WordPress.org support forums.
- Troubleshooting allows you to have a clean WordPress session, where all plugins are disabled, and a default theme is used, but only for your use until you disable it or log out.
- The Tools section allows you to check that WordPress files have not been tampered with, that emails can be sent, and if your plugins are compatible with any PHP version updates in the future.
Installing Health Check & Troubleshooting
Installing Health Check & Troubleshooting plugin is super easy.
- You can install this plugin directly by going to your WordPress Dashboard > Plugins > Add New.
- Now enter Health Check & Troubleshooting in the search bar and wait for the screen to refresh.
- Install and Activate the plugin.
Using Health Check to find Website Problems
Once you’re done with the installation and activation. Go to Tools > Site Health > Troubleshooting > Enable Troubleshooting Mode (to start troubleshooter). Once you complete these steps, you are in troubleshooting mode.
While in the Troubleshooting Mode, All the plugins and the theme on your website have been disabled only for you.
In this case, we talk about Rank Math SEO Plugin. The error is: The sidebar button is greyed out and when I press it, it takes me to this page that says The editor has encountered an unexpected error. I am not able to access the SEO for any of my pages.
Verifying a Theme/Plugin Conflict
Step 1 – Disable all plugins and your theme, try checking the issue you’re dealing with (here, in this case, the editor is encountering unexpected error). If you still have the issue, your WordPress setup is the root of the problem. If not, then move to the next step.
Step 2 – On the top bar, navigate to the Troubleshooting Mode, hover over it, and select Themes > Twenty-Twenty. After that, try to reproduce the issue. Check the issue again. If you don’t see the issue, then your theme is conflicting with Rank Math. If not, then the theme is not causing issues. So, continue to the next step.
Step 3 – Navigate to the Troubleshooting Mode in the top bar again. This time hover over the plugins section. Click on any one of the plugins to enable it and check your issue. If you have the issue, then this particular plugin you just activated is conflicting with Rank Math. If not, then this plugin is not causing issues with the Rank Math.
Repeat Step 3 by enabling one plugin at a time and checking if the problem exists. If yes, the plugin you last activated is causing the issue.
What to do if you find Theme/Plugin conflict?
Once you found the main cause of the problem, be it a Theme or Plugin issue, you have several options here.
- Like in the case of the Theme you can contact its developers. Same will the case with any of the Plugins and state your matter.
- You can change the Theme if your problem is not being resolved. In case of Plugins, you can disable it and install another plugin which works alike. For example, in this case, you can install Yoast SEO or All in One SEO plugins instead of Rank Math.
- If the problem with the theme or plugin is of larger nature (you can find this by checking the same issue over the internet), then the theme or plugin developers will surely come up with an update and will fix the issue.
- Finally, if the issue persists even when only the default WordPress theme (Twenty Twenty) and Rank Math are active and all other themes and plugins are disabled, then the problem is beyond this scope and you need to contact the developers (or try any of the other solutions stated above).
Health Check & Troubleshooting – FAQ
I am unable to access my site after enabling troubleshooting.
If you find yourself stuck in Troubleshooting Mode for any reason, you can simple disable it by clearing your cookies.
If you don’t know how to clear your cookies, close all your browser windows, and restart your computer and it will clear this specific cookie automatically.
The PHP compatibility says this plugin only work with PHP version X
The plugin is made to be a support tool for as many users as possible, this means it needs code that is written for older sites as well.
Tools that check for PHP compatibility do not know how to separate this code from the real code, so it will give a false positive response.
At this time, the plugin has been tested with every version of PHP from 5.2 through 7.3, and works with all of these.
[VIDEO TUTORIAL] Solve WordPress Issues: Site Health Check & Troubleshooting (Theme/Plugin Conflict) [Urdu/Hindi]
- [1:16] The Problem with Rank Math SEO Plugin (Case Study): The Editor is Encountering an Unexpected Error.
- [3:25] Theme/Plugin Conflict or Bug on Website – Main Causes of Problem
- [4:44] Health Check & Troubleshooting (WordPress Plugin)
- [5:40] How to use Health Check & Troubleshooting to find Website Problems?
- [7:55] How to enable and use Health Check Troubleshooting Mode?
- [10:07] Verifying a Theme/Plugin Conflict (Using Troubleshooting Mode)
- [11:04] Verifying a Theme Conflict
- [12:02] Verifying a Plugin Conflict
- [16:09] What to do if you find Theme/Plugin conflict?