Debugging Errors on WordPress & Viewing Logs

Last Updated -

For issues relating to the "Error Rendering Page." like below:


With SSH/terminal access:

SSH into the VPS via Terminal

Then run the command below to view most recent PHP errors:

$ pagely error:php ~/sites/

To tail the error log live, as errors are occurring:

$ pagely error:php ~/sites/ --follow

Then reload the error page in the browser & the terminal output should show the line.

With sFTP access only:

Add the following code to the top of the wp-config.php file.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

The error log will then be viewable in a browser at the URL, or through sFTP at the /wp-content/debug.log location.

  • When finished debugging:
    • Comment or remove the lines added above to the wp-config.php file.
    • The system will automatically remove the debug.log file for you shortly after so you don't need to worry about it.
    • If you are concerned with leaving this available since it is publicly accessible you can delete the /wp-content/debug.log file through sFTP.

Bypassing our error page:

We cannot disable the error page, but you can bypass it to see what errors are poping up.

Add the following code to the top of the wp-config.php file:

if (false !== strpos($_SERVER['REQUEST_URI'], 'debug')) {
    define('WP_DEBUG', true);

To view the error, add /?debug to the end of the URL that's erroring out.

For more on this topic: A Guide to Using WordPress Logs to Track Errors

Related Topics

Pagely is the Managed WordPress Hosting Platform designed to exceed the needs of media, business, and Enterprise customers alike. We help the world's biggest brands scale WordPress.

Copyright © 2006-2017 Pagely, Inc. All rights reserved.
Pagely® and WordPress® are registered trademarks.

Powered by Zendesk