Title: Health Check &amp; Troubleshooting
Author: WordPress.org
Published: <strong>June 9, 2018</strong>
Last modified: July 25, 2024

---

Search plugins

![](https://ps.w.org/health-check/assets/banner-772x250.png?rev=1823210)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/health-check/assets/icon.svg?rev=1828244)

# Health Check & Troubleshooting

 By [WordPress.org](https://profiles.wordpress.org/wordpressdotorg/)

[Download](https://downloads.wordpress.org/plugin/health-check.1.7.1.zip)

 * [Details](https://wordpress.org/plugins/health-check/#description)
 * [Reviews](https://wordpress.org/plugins/health-check/#reviews)
 * [Development](https://wordpress.org/plugins/health-check/#developers)

 [Support](https://wordpress.org/support/plugin/health-check/)

## 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](https://make.wordpress.org/support/handbook/appendix/troubleshooting-using-the-health-check/).

Feedback is welcome both through the [WordPress.org forums](https://wordpress.org/support/plugin/health-check),
the [GitHub project page](https://github.com/WordPress/health-check), or on [Slack](https://make.wordpress.org/chat)
in either [#forums](https://wordpress.slack.com/messages/forums/) or [#core-site-health](https://wordpress.slack.com/messages/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](https://hackerone.com/wordpress)
program.

## Reviews

![](https://secure.gravatar.com/avatar/bc1072ef8df056216caf6bd9604c7a06044ce95e1a6b9ab14cd086d71ede5d1c?
s=60&d=retro&r=g)

### 󠀁[I can’t believe that](https://wordpress.org/support/topic/i-cant-believe-that/)󠁿

 [Da3sa](https://profiles.wordpress.org/abuwassan/) April 4, 2026

I can’t believe anyone gave this plugin 5 stars. Troubleshooting mode will break
your site. It disables ALL plugins and it says that this will only affect you and
NOT your other site visitors but that is FALSE. When you disable troubleshooting
mode all plugins remain inactive! There is NO WAY to revert or cancel this. Once
you enter troubleshooting mode you are screwed. My entire site was broken and I 
had to scramble to reactive plugins one by one.

![](https://secure.gravatar.com/avatar/60198d4eca85554b61891c97d648837ed426fefc412f99106265f16088134354?
s=60&d=retro&r=g)

### 󠀁[It is Very helpful tool for developers](https://wordpress.org/support/topic/very-helpful-tool-for-developers-2/)󠁿

 [whizPlugins](https://profiles.wordpress.org/whizplugins/) February 17, 2026

It is Very helpful tool for developers

![](https://secure.gravatar.com/avatar/93c8c447a854c42e4c2aedb2087359352590739729edfd6ae51aa4b4c2506d12?
s=60&d=retro&r=g)

### 󠀁[Service Recommended](https://wordpress.org/support/topic/service-recommended-5/)󠁿

 [deynadc9](https://profiles.wordpress.org/deynadc9/) January 16, 2026

The plugin is very good, I’m happy with it and I recommend it.

![](https://secure.gravatar.com/avatar/90ab93a31e38450090f9b483c04c5dd6b09f2e4514de1764fbd4da129acc9841?
s=60&d=retro&r=g)

### 󠀁[Absolute Life saver on my agency sub sites..](https://wordpress.org/support/topic/absolute-life-saver-on-my-agency-sub-sites/)󠁿

 [akehsanz](https://profiles.wordpress.org/pixarzbd/) January 13, 2026

I’ve been facing few unresolved problems — that was easily identified by this plugin..
really appreciate the efforts from dev team… thanks

![](https://secure.gravatar.com/avatar/3d492789bf40a34781db4e222d6c2e276bd32979e761472708659475f49fcbfc?
s=60&d=retro&r=g)

### 󠀁[good](https://wordpress.org/support/topic/good-9054/)󠁿

 [carrie06](https://profiles.wordpress.org/carrie06/) December 16, 2025

good app!

![](https://secure.gravatar.com/avatar/7fce164e03d8ce57f79b60f19e8bb3e7c5c6136ae593f74dc064d8e0ac883551?
s=60&d=retro&r=g)

### 󠀁[good](https://wordpress.org/support/topic/good-9010/)󠁿

 [susan54](https://profiles.wordpress.org/susan54/) October 13, 2025

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

 [ Read all 180 reviews ](https://wordpress.org/support/plugin/health-check/reviews/)

## Contributors & Developers

“Health Check & Troubleshooting” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)
 *   [ Peter Westwood ](https://profiles.wordpress.org/westi/)
 *   [ Gary Pendergast ](https://profiles.wordpress.org/pento/)
 *   [ Marius L. J. ](https://profiles.wordpress.org/clorith/)

“Health Check & Troubleshooting” has been translated into 33 locales. Thank you 
to [the translators](https://translate.wordpress.org/projects/wp-plugins/health-check/contributors)
for their contributions.

[Translate “Health Check & Troubleshooting” into your language.](https://translate.wordpress.org/projects/wp-plugins/health-check)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/health-check/), check
out the [SVN repository](https://plugins.svn.wordpress.org/health-check/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/health-check/) by
[RSS](https://plugins.trac.wordpress.org/log/health-check/?limit=100&mode=stop_on_copy&format=rss).

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

## Community plugin

This plugin is developed and supported by a community. [Contribute to this plugin](https://github.com/WordPress/health-check)

## Meta

 *  Version **1.7.1**
 *  Last updated **2 years ago**
 *  Active installations **300,000+**
 *  WordPress version ** 4.4 or higher **
 *  Tested up to **6.6.5**
 *  PHP version ** 5.6 or higher **
 *  Languages
 * [Arabic](https://ar.wordpress.org/plugins/health-check/), [Catalan](https://ca.wordpress.org/plugins/health-check/),
   [Chinese (China)](https://cn.wordpress.org/plugins/health-check/), [Chinese (Taiwan)](https://tw.wordpress.org/plugins/health-check/),
   [Czech](https://cs.wordpress.org/plugins/health-check/), [Dutch](https://nl.wordpress.org/plugins/health-check/),
   [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/health-check/), [English (Australia)](https://en-au.wordpress.org/plugins/health-check/),
   [English (Canada)](https://en-ca.wordpress.org/plugins/health-check/), [English (New Zealand)](https://en-nz.wordpress.org/plugins/health-check/),
   [English (South Africa)](https://en-za.wordpress.org/plugins/health-check/), 
   [English (UK)](https://en-gb.wordpress.org/plugins/health-check/), [English (US)](https://wordpress.org/plugins/health-check/),
   [French (France)](https://fr.wordpress.org/plugins/health-check/), [German](https://de.wordpress.org/plugins/health-check/),
   [German (Switzerland)](https://de-ch.wordpress.org/plugins/health-check/), [Greek](https://el.wordpress.org/plugins/health-check/),
   [Italian](https://it.wordpress.org/plugins/health-check/), [Japanese](https://ja.wordpress.org/plugins/health-check/),
   [Korean](https://ko.wordpress.org/plugins/health-check/), [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/health-check/),
   [Persian](https://fa.wordpress.org/plugins/health-check/), [Polish](https://pl.wordpress.org/plugins/health-check/),
   [Portuguese (Brazil)](https://br.wordpress.org/plugins/health-check/), [Portuguese (Portugal)](https://pt.wordpress.org/plugins/health-check/),
   [Romanian](https://ro.wordpress.org/plugins/health-check/), [Russian](https://ru.wordpress.org/plugins/health-check/),
   [Spanish (Argentina)](https://es-ar.wordpress.org/plugins/health-check/), [Spanish (Chile)](https://cl.wordpress.org/plugins/health-check/),
   [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/health-check/), [Spanish (Spain)](https://es.wordpress.org/plugins/health-check/),
   [Spanish (Venezuela)](https://ve.wordpress.org/plugins/health-check/), [Swedish](https://sv.wordpress.org/plugins/health-check/),
   and [Ukrainian](https://uk.wordpress.org/plugins/health-check/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/health-check)
 * Tag
 * [health check](https://wordpress.org/plugins/tags/health-check/)
 *  [Advanced View](https://wordpress.org/plugins/health-check/advanced/)

## Ratings

 3.6 out of 5 stars.

 *  [  107 5-star reviews     ](https://wordpress.org/support/plugin/health-check/reviews/?filter=5)
 *  [  7 4-star reviews     ](https://wordpress.org/support/plugin/health-check/reviews/?filter=4)
 *  [  4 3-star reviews     ](https://wordpress.org/support/plugin/health-check/reviews/?filter=3)
 *  [  5 2-star reviews     ](https://wordpress.org/support/plugin/health-check/reviews/?filter=2)
 *  [  57 1-star reviews     ](https://wordpress.org/support/plugin/health-check/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/health-check/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/health-check/reviews/)

## Contributors

 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)
 *   [ Peter Westwood ](https://profiles.wordpress.org/westi/)
 *   [ Gary Pendergast ](https://profiles.wordpress.org/pento/)
 *   [ Marius L. J. ](https://profiles.wordpress.org/clorith/)

## Support

Issues resolved in last two months:

     0 out of 3

 [View support forum](https://wordpress.org/support/plugin/health-check/)