How To: Enable Debug Mode in WordPress


Sometimes your WordPress website may not load correctly, and may just display a white page.

When this happens, the next step to figuring out the problem is to enable Debug mode for WordPress. 

Debug mode will output all PHP errors to your browser, or to a log file, including missing module errors, syntax errors, and information about deprecated functions.

Please note: It is not recommended to use WP_DEBUG or the other debug tools on live sites; they are meant for local testing and staging installs.


To enable Debug mode, please follow the below steps:

1. Open your website's wp-config.php file in a text editor. In the below example, I will be using 'nano' via SSH to edit the file. To launch nano text editor, I use the below SSH command:

# nano /path/to/website/wp-config.php 

2. Find the line that says define('WP_DEBUG', false); and change it to define('WP_DEBUG', true);

Note: The true and false values in the example are not surrounded by apostrophes (') because they are boolean (true/false) values. If you set constants to 'false', they will be interpreted as true because the quotes make it a string rather than a boolean.



3. Save the file. (In nano, to save the file, press CTRL + X, then press Y, then ENTER)

Debug mode should now be enabled.

To disable debug mode, revert your changes to the wp-config.php file.



Have more questions? Submit a request