Use the Health Check & Troubleshooting plugin to resolve errors

The Health Check & Troubleshooting plugin can help you find plugin and theme conflicts on your live site without affecting the live site publicly. This guide will show you how to install and use the Health Check & Troubleshooting plugin to resolve errors.

This feature is available on sites with the WordPress.com Personal, Premium, Business, and Commerce plans. For free sites, upgrade your plan to access this feature.

Follow these steps to troubleshoot plugin and theme issues without impacting your site’s visitors:

1. Install and activate the Health Check & Troubleshooting plugin.
2. In your site’s dashboard, navigate to Tools → Site Health.
3. Click on the Troubleshooting tab.
4. Click the “Enable troubleshooting mode” button and wait for the page to refresh.
5. At the top of the page, click on the toggle arrow beside “Available Themes” and activate a default WordPress theme such as Twenty Twenty-Four, Twenty Twenty-Five, or the Storefront Theme for WooCommerce stores. This step helps establish whether your usual theme is the source of the problem.
6. Check your site to see if the issue persists.
   • If the error goes away, your theme is causing the issue. Either change your theme or contact the theme developer for a resolution.
   • If the issue persists, proceed to the next step.
7. Open the “Available plugins” section. Note that all plugins are now inactive for you, but your site’s visitors will not experience any changes.
8. Click the “Enable” button next to one of the plugins. You may start with the ones you suspect the most or begin at the top of the list.
9. After activating a plugin, verify if the issue is still present.
10. Keep activating plugins one by one and checking your site each time. When the issue reappears after activating a specific plugin, you’ve identified the cause.
11. If no issue appears after reactivating all plugins, switch from the default theme back to your active theme. If the problem then reappears, you’ll know the conflict is related to your theme.
12. After identifying the problematic plugin or theme, end troubleshooting mode by clicking “Disable Troubleshooting Mode.”
13. Navigate either to Plugins → Installed plugins to deactivate the plugin that caused the issue, or to Appearance → Themes to switch to a different theme if the issue was with the theme.
14. Contact the plugin or theme developer to fix the problem.