How to Diagnose WordPress Website Issues with WP Doctor

WordPress is a robust content management system that powers millions of websites worldwide. However, like any complex software, it’s not uncommon to encounter issues occasionally. 

Whether you’re dealing with blank pages, upload problems, failed upgrades, or timeouts, these problems can be frustrating and time-consuming to troubleshoot. That’s where WP Doctor comes in – a tool specifically designed to help WordPress users quickly and efficiently diagnose problems with their website. 

In this article, we’ll explore the power of this solution and how it can help you keep your website running smoothly.

Table of Contents:

  1. What is WP Doctor?
  2. How to Install and Use WP Doctor?
  3. Optimizing WordPress Experience With ScalaHosting
  4. FAQ

What is WP Doctor? 

WP Doctor is a plugin created to help WordPress users diagnose and troubleshoot various issues that may arise with their website. It runs a series of checks to identify potential symptoms and provide valuable suggestions to resolve them. 

How to Install and Use WP Doctor? 

Installing and using WP Doctor is nothing complicated. All you need to do is execute the following command in the document root of your site:

wp package install

Once the installation is complete, you can run default checks by executing the following command:

wp doctor check –all

If you executed everything right, here’s what you should see:

Running checks  100% 

========================================================] 0:06 / 0:04
| name                       | status  | message                                                            |
| core-verify-checksums      | success | WordPress verifies against its checksums.                         |
| file-eval                  | success | All ‘php’ files passed check for ‘eval\(.*base64_decode\(.*’.      |
| cache-flush                | success | Use of wp_cache_flush() not found.                                 |
| autoload-options-size      | success | Autoloaded options size (6.1kb) is less than threshold (900kb).    |
| constant-savequeries-falsy | success | Constant ‘SAVEQUERIES’ is undefined.                            |
| constant-wp-debug-falsy    | success | Constant ‘WP_DEBUG’ is defined falsy.                             |
| core-update                | warning | A new major version of WordPress is available for update.      |
| cron-count                 | success | Total number of cron jobs is within normal operating expectations. |
| cron-duplicates            | success | All cron job counts are within normal operating expectations.      |
| option-blog-public         | success | Site is public as expected.                                        |
| plugin-active-count        | success | Number of active plugins (0) is less than threshold (80).     |
| plugin-deactivated         | warning | Greater than 40 percent of plugins are deactivated.            |
| plugin-update              | warning | 1 plugin has an update available.                                  |
| theme-update               | warning | 3 themes have updates available.                                   |
| php-in-upload              | success | No PHP files found in the Uploads folder.                          |
| language-update            | success | Languages are up to date.                                          |

Here’s a breakdown of each check:

  • Core-verify-checksums: Verifies the integrity of the core files and alerts you to any modifications.
  • File-eval: Audits files for potentially harmful code and suggests running a scan if there are any warnings.
  • Cache-flush: Locates the number of occurrences of the wp_cache_flush() function and provides suggestions for resolving any issues.
  • Autoload-options-size: Checks the size of automatically loaded options and can help identify larger problems.
  • Constant-savequeries-falsy: Confirms the expected state of the SAVEQUERIES constant, which can be resource-heavy if used in production.
  • Constant-wp-debug-falsy: Checks if WP debug is turned on and provides recommendations for managing it on production sites.
  • Core-update, plugin-update, and theme-update: Checks if there are any available updates for your site’s core files, plugins, and themes.
  • Cron-count and cron-duplicates: Provides information and recommendations for adjusting your configured WP crons.
  • Option-blog-public: checks if your site is publicly available.
  • Plugin-active-count and plugin-deactivated: Checks the installed extensions and provides insights on possible optimizations.
  • PHP-in-upload: Shows a warning when a PHP file is present in the Uploads folder.
  • Language-update: Checks if there is a new version of the installed language.

If you only need to run specific checks, WP Doctor also allows for customized scans. For example, you can run a check for autoload-options-size and core-verify-checksums with the following command:

wp doctor check autoload-options-size core-verify-checksums

Now that you know how to install and use WP Doctor, you can harness its full power to ensure your website functions optimally and identify potential issues before they become significant problems!

Optimizing WordPress Experience With ScalaHosting

Need assistance with your WordPress setup? We’re always here to help!

With ScalaHosting’s simplified installation process, you can have your website up and running in no time! We offer access to over 400 scripts, integrations, and features that can enhance your site’s performance. 

The ScalaHosting plans also come with a range of management perks, including automatic WordPress updates, cloning, staging, and on-demand backups. 

And the best part is – you can do all of that with just 1 click!

Pair our Managed WordPress hosting plans with the powerful OpenLiteSpeed technology and LiteSpeed cache plugin to speed up your site, increase visitors, improve user experience, and enhance your search engine optimization.

Worried about security? Don’t be! Our unique SWordPress Manager tool offers the WordPress LOCK feature to keep your website ultra-secure and unhackable!

And if you need expert assistance with your WordPress site, the WP Fix It team can help with any CMS issues in 30 minutes or less!

Not sure how to get started? Our expert team is available 24/7/365 to assist with any inquiries you might have! Contact us today to learn more about the plans and perks we offer!

Frequently Asked Questions

Q: What is WP Doctor?

A: WP Doctor is a diagnostic tool for WordPress websites. It scans a website for potential issues and provides information about potential problems and recommended solutions.

Q: Who can benefit from using WP Doctor?

A: WP Doctor is useful for anyone who manages a WordPress website, including developers, designers, and site owners. The tool can help identify potential issues before they become major problems and provides recommendations for fixing them.

Q: How do I install WP Doctor?

A: WP Doctor can be installed using the WP-CLI command-line tool. Once WP-CLI is configured, you can run the command “wp package install wp-cli/doctor” to add WP Doctor to your WordPress installation.

Q: What kinds of checks does WP Doctor perform?

A: WP Doctor performs a variety of checks related to WordPress core files, file permissions, plugin/theme updates, cron jobs, and more. It also allows users to customize which checks are performed and view detailed information about the results.

Q: Can WP Doctor fix issues automatically?

A: No, WP Doctor is a diagnostic tool that does not automatically change a website. It provides information and recommendations for fixing issues, but users must manually make changes to their site to implement the suggestions.

Was this helpful?

What’s your goal today?

1. Find the right Managed VPS solution

If you’re looking for industry-leading speed, ease of use and reliability Try ScalaHosting with an unconditional money-back guarantee.

2. Make your website lighting fast

We guarantee to make your WordPress site load in less than 2 seconds on a managed VPS with ScalaHosting or give your money back. Fill out the form, and we’ll be in touch.

Please enter a valid name
Please enter a valid website
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

3. Streamline your clients’ hosting experience

If you’re a web studio or development agency hosting more than 30 websites, schedule a call with Vlad, our co-founder and CTO, and see how we can deliver unmatched value to both your business and your clients.


Need a custom cluster or professional advice?

Book a meeting and get a free 30-minute consultation with Vlad, co-founder & CTO of Scala Hosting, who will help you select, design and build the right solution - from a single data center cluster to a multi-region & multi-datacenter high availability cluster with hundreds of servers.

Book a free consultation

4. Learn how to grow your website in 2024

An all-star team of SEO and web influencers are sharing their secret knowledge for the first time in years. Learn about the future of SEO, Web Design best practices and the secrets to getting the foundation for your website to thrive. Watch the exclusive webinar.

An Exclusive Insiders Look Behind The SEO and Web Development Curtain


Working in the web hosting industry for over 13 years, Rado has inevitably got some insight into the industry. A digital marketer by education, Rado is always putting himself in the client's shoes, trying to see what's best for THEM first. A man of the fine detail, you can often find him spending 10+ minutes wondering over a missing comma or slightly skewed design.