Turning on WordPress Debugging

In this article, we will teach you how to turn WordPress debugging on. With debugging turned on, it is much easier to locate any errors within your WordPress site as well as any plugins and themes that may be causing errors.

For fast, secure WordPress be sure to check out InMotion’s WordPress Hosting package.

Enabling WordPress debugging within your wp-config.php using the cPanel File Manager

WordPress debugging is something that is enabled within your wp-config.php file. With just a simple edit to this file, you will be able to view any errors produced within WordPress.

  1. First, be sure that you are logged into cPanel.
  2. <li style="clear:both;"><a href="https://www.inmotionhosting.com/support/wp-content/uploads/2014/01/wordpress_wordpress-debugging-1.png" rel="lightbox-0"><img class="std_ss" src="https://www.inmotionhosting.com/support/wp-content/uploads/2014/01/wordpress_wordpress-debugging-1.png" style="float:right; margin:15px 15px 15px 15px;"></a>

    Now that you are logged into cPanel, look for the icon that says File Manager and click on it.

  3. Within your public_html directory, you will see a file labeled wp-config.php. Right-click on it, then click on Code Editor.
  4. At the bottom of your wp-config.php file, add the following lines:
  5. define( ‘WP_DEBUG’, true );
    define( ‘SCRIPT_DEBUG’, true );

    The first line will cause WordPress to display any errors caused by various PHP functions that are built into WordPress. The second line will display any errors for WordPress’ built-in JavaScript and CSS.

  6. After you have edited the wp-config.php file, be sure to save your changes by clicking on the Save Changes button at the top right of the file manager.

Now that the you have enabled debugging within WordPress, you should now be able to see any errors that are produced within your WordPress site.

Thoughts on “Turning on WordPress Debugging

    • Hello Aadhi,

      You can post your files in the same location as your WordPress installation files on the web server. If you’re not familiar with how to find those files, then you may need to review the installation documentation for WordPress. The manual installation will be the easiest way to learn about where your WordPress files live.

      If you have any further questions, please let us know.

      Kindest regards,
      Arnel C.

  • So after I edited the wp-config.php and saved it, what the next process, whats the step 6? I just wait on my screen and see the errors?

    • Mang, once you have edited the file you should be able to see any errors on your WordPress pages, if there are any. If you don’t see any error messages, there may not be anything wrong.

    • It looks like you have not defined the action the button is supposed to take. I’d consider comparing it to another pages that works properly.

    • Hello Jo,

      It’s a good question! The debug option changes a number of behaviors and can also be modified even further. First, PHP errors may be displayed on the screen (front end or backend), and may also be recorded in the debug.log file in the wp-content folder. You can find out much more about the debug mode by reviewing this article.

      If you have any further questions or comments, please let us know.

      Arnel C.

  • well that didn’t work either, gave me nothing but errors, my issue is with the new version of wordpress, my classified site was good with 4.5, but upgrade to 4.5.1 & 2 I get the auto draft message instead of the actual post, I just tried on my localhost site with older version of same theme and works great, but once update the wordpress I get auto draft..

  • after i put the code into the file.  how do i get the site to start the debugging process.  I dont’ know what step to take next and I cannot locate the email any more.


    Thank you for any and all assistance!

    • Hello Lea,

      After turning on wordpress debugging, any php errors, warnings, or notices will be displayed. So essentially you would try to get an error for what ever the reason you needed the wordpress debugging on to start with.

      Kindest Regards,
      TJ Edens

Was this article helpful? Let us know!