1. Home
  2. Knowledge Base
  3. WordPress
  4. How To – Fix The WordPress White Screen in cPanel

How To – Fix The WordPress White Screen in cPanel

The White Screen of Death (WSOD) is one of the most common issues in WordPress.
It can be frustrating, but it can generally be resolved by following these guide:

Before making any changes, it’s important to ensure you have a backup of your website. You can use a backup plugin like UpdraftPlus or your preferred one, or do it manually through cPanel.

 

Enable WordPress Debugging

Debugging will help you identify the exact error causing the white screen. Open the wp-config.php file in the root directory of your site and add the following lines just before /* That’s all, stop editing! */:

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

 

This will enable debugging and save error logs to a debug.log file in the /wp-content/ folder. Now, reload your site, and you’ll be able to observe the errors that led to the white screen. Below are example errors:

Fatal error: Allowed memory size of X bytes exhausted (tried to allocate Y bytes) in /path/to/file.php on on line 89

Fatal error: Call to undefined function function_name() in /path/to/file.php on line 51

 

Increase the memory limit

If, after enabling WordPress debug mode, you encounter the error ‘Fatal error: Allowed memory size of X bytes exhausted’, it is because your site has exhausted or reached the allocated memory limit. You will need to allocate more memory to the application.

This can be done through the wp-config.php file in many WordPress installations. Open the file and add the following code:

define('WP_MEMORY_LIMIT', '256M');

Check Your Plugins

Plugins are often the cause of the white screen. To check if a plugin is causing the issue, follow these steps:

1. Go to the /wp-content/plugins/ directory.

2. Rename the folder of the plugin you suspect is causing the problem. For example, you can change ‘plugin-name‘ to ‘plugin-name-disabled‘.

3. Try accessing your website again. If the white screen disappears, you’ll know that particular plugin was the cause.

 

Check Your WordPress Theme

If disabling plugins doesn’t solve the problem, it’s possible that the theme is the culprit. Follow these steps to check it:

1. Go to the /wp-content/themes/ directory.

2. Rename the folder of the active theme. For example, you can change ‘theme-name‘ to ‘theme-name-disabled‘.

3. Try accessing your website again. If the white screen disappears, the theme was the issue.

 

Note: It’s always recommended to keep WordPress themes and plugins updated to their latest versions as this helps prevent the white screen error and maintains website security, making it less vulnerable to infections and security breaches.

 

Check File Permission Issues

Another possible cause of the white screen is file and folder permissions.
In this case, access the file manager and verify that they have the following permissions:

  • Folders – 755
  • Files – 644

If the main files or folders of the site do not have these permissions, assign the correct ones.

Contact Your Hosting Provider or Developer

If you still have the white screen after following these steps, it’s possible that the problem is more complex and may require assistance from your hosting provider or developer.

Share
Was this article helpful?

Related Articles

Need Support?

Can't find the answer you're looking for?
Contact Support

Trusted by Our Clients

Tell us about your website needs - we’d like to hear from you!

What's New

The Benefits of Custom WooCommerce Development: Unveiling the Unmatched Advantages

You and your company work hard to leverage your strategic advantages… shouldn’t your eCommerce solution be aligned to do the… more

How to find the Best WooCommerce Developers

So you’ve done your research and have come to the conclusion that WooCommerce is the right solution for your eCommerce… more

Read All