Health Check & Troubleshooting

by WordPress.org

Description

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 user 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.

For a more extensive example of how to efficiently use the Health Check plugin, check out the WordPress.org support team handbook page about this plugin.

Feedback is welcome both through the WordPress.org forums, the GitHub project page, or on Slack in either #forums or #core-site-health.

Screenshots

The health check screen after the automated tests have gone over the system.
The debug information, with the copy and paste field expanded.
A selection of tools that can be ran on your site.
Troubleshooting mode enabled, showing your website Dashboard

Faq

I am unable to access my site after enabling troubleshooting

If you should find your self stuck in Troubleshooting Mode for any reason, you can easily disable it by clearing your cookies.

Are you unfamiliar with how to clear your cookies? No worries, you may also close all your browser windows, or perform a computer restart 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.

Where can I report security bugs?

The Site Health team and WordPress community take security bugs seriously. We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions.

To report a security issue, please visit the WordPress HackerOne program.

Reviews

good

By susan54 on October 13, 2025

A must-have plugin for diagnosing site issues and resolving conflicts quickly. Simple, effective, and reliable.

Good for Troubleshooting

By Michael Fridrich (michaelfridrich) on September 24, 2025

Really helps with diagnosing issues. Finds conflicts easier.

Great plugin

By leemon on September 12, 2025

This is an essential plugin for troubleshooting plugin and theme conflicts

Authors are slow to fix issues

By kal123 on September 8, 2025

This issue has been open for almost a year and not fixed:

Notice: Function _load_textdomain_just_in_time was called incorrectly. Translation loading for the health-check domain was triggered too early. This is usually an indicator for some code in the plugin or theme running too early. Translations should be loaded at the init action or later. Please see Debugging in WordPress for more information. (This message was added in version 6.7.0.) in .../public_html/wp-includes/functions.php on line 6121

Very good for getting essential details

By surviving404 on September 3, 2025

I do not have to guide inexperienced users through a long process because of this.

Essential Tool for WordPress Site Diagnostics

By shumaylmasruqhandal on August 29, 2025

Health Check & Troubleshooting is one of those must-have plugins if you manage a WordPress site. It runs quick checks to spot common errors and configuration issues, and the debugging info makes it easy to share details with support teams.

Useful

By Celso Almeida (celsoalmeida) on May 23, 2025

Very simple, useful and clean plugin. Easy to use.

Could it be harder to use?

By Steve (aksteve) on April 30, 2025

I tried this, but found it very confusing to figure out just what it did and what makes it so special. I couldn't reactivate any plugins. So how am I suppose to troubleshoot.

This is just FLUFF... if you want to trouble shoot just do it the old school way, turn all plugins and themes off, and then just painstakingly turn them on, one-by-one. THis plugin does not make it any easier. In fact, I think it makes it harder.

Final thought - don't even bother.

Good Plugin

By Quotes Ninja (quotesninja) on March 29, 2025

I think this plugin is in-bult. Till now this plugin does not create any problem for my website.

It definitely does its job

By Roman Bondar (romanbon) on January 19, 2025

If you know what you are doing, this plugin is priceless. For some features, there are no alternatives at all.

Changelog

1.7.1 (2024-07-25)

Security: Prevent a potential information disclosure from the screenshot beta feature, reported independently by Jarko Piironen.
Security hardening: Make each screenshot delete nonce unique to that image.
Security hardening: Add a capability check alongside the nonce validation when toggling beta features on or off.
General: Updated the Tested up to tag.
General: Added notice about future changes to the Troubleshooting and Tools sections.
Added Twenty Twenty Four as a known and valid default theme.
Tools: Fixed a PHP warning when checking for PHP version compatibility and no data was found.
Tools: Fixed a PHP warning when WP_DEBUG is disabled, or nothing has been written to the logfile yet.
Tools: Improved the description for the robots.txt file viewer.

1.7.0 (2023-08-06)

General: Improved styling inconsistency between the plugin and WordPress core.
General: Fixed an issue with plugin translations where language strings would get mixed when using third party language plugins, or a separate profile language.
Troubleshooting Mode: Fixed the URL used when disabling elements and having a subdirectory installation.
Troubleshooting Mode: Fixed a deprecation warning when disabling troubleshooting mode on PHP version 8.3 or higher.
Troubleshooting Mode: Added reference on how to troubleshoot as different users when testing scenarios.
Tools: Fixed integration with WPTide for the PHP Compatibility checker.
Tools: Added a viewer that will display debug log output when enabled.
Tools: Added a warning to the File Integrity tester if unexpected files are mixed in with WordPress core files.
Tools: Added a warning if sending emails is taking longer than expected.
Tools: Added beta feature toggle for those who wish to test new functionality that may not be fully ready yet.
CLI: Fixed the CLI commands, you can now wp health-check status to your hearts content!
Beta feature: Added a new beta feature, making it easier for non-technical users to grab screenshots of issues on their site, and share them.