Wednesday, April 15, 2020
How to Fix the White Screen of Death in WordPress
How to Fix the White Screen of Death in WordPress post-1758" class="post-1758 post type-post status-publish format-standard has-post-thumbnail hentry category-wordpress-tutorials">If youve been blinded by the whiteness of your site and found a blank screen staring at you then youve already met the infamous white screen of death in WordPress (aka. WSOD).One minute the site works okay, and the other everything goes blank. (This can also happen when your dashboard isnt loading properly even though the front of the site is actually working.)Today, lets look into what causes the white screen of death in WordPress and how to fix it:The most common causes of the white screen of death in WordPressCause #1: Auto upgrade issuesThe symptoms may mimic those of a misconfigured database presenting you with a white screen with no information at all. Or you may see a warning of a failed update.These occur when theres a connection problem that interrupts your updates or incorrect file permissions, which you need to fix.If you encounter this issue, youll need to do a manual WordPress upgrade.Cause #2: Maintenance mode freezeSometimes WordPress gets stuck at:It means that a .maintenance file, which WordPress automatically installs when it starts updating, hasnt been removed.To do this manually, youll need to log in to your site using an FTP client or via your hosting dashboard (cPanel, Plesk, etc) and delete .maintenance, located in your website root folder.Cause #3: Problems with pluginsThe white screen of death in WordPress is a possible culprit if you attempt to:Modify an active pluginUpdate an old oneInstall a new pluginIn many cases, the plugin that has just been installed or modified could result in a conflict with your current theme or other plugins. Thats why its important to use WordPress products developed using best practices.Try to disable any recently modified or installed plugins and see if your WordPress goes back to normal.In case your dashboard isnt operational at all, you can disable plugins in WordPress using FTP access. A caveat is that youll only be able to do this if you have access to your FTP with the required directory permissions. Most hosting companies provide FTP service. However, if WordPress is installed on a Virtual Private Server or youre with a managed host, you might not have an FTP server.You may need to install an FTP client, such as FileZilla.To disable the plugin:Use an authorized account to sign in to your FTP serverFind your WordPress installation directory and open the folder wp_content/pluginsSelect the folder with the plugins nameRename the folder to a different name you can still recognize e.g. if the folder is called my-bad-plugin name it _my-bad-plugin or my-bad-plugin_disabled. Choose any name provided it doesnt sound like any other plugins name and you can remember it laterThats it! Renaming the folder permanently disables the pluginReopen your browser and see whether your site loads. Use the above steps to disable as many plugins as you need to in order to combat the white screen of death in WordPress.Alternatively, you can disable all of your WordPress plugins simultaneously. Heres how:Disabling all your plugins one by one could take you a longer while. Instead, you can rename the main plugins folder to something else, e.g. from wp_content/plugins to wp_content/plugins_old. This should disable all your plugins simultaneously.Then, create another folder called wp_content/plugins. You can activate each plugin by moving them to the new plugins folder.If your case of the white screen of death in WordPress was caused by a particular plugins modification, disabling the plugin through your FTP server should resolve the problem. As a rule of thumb, test all your modified plugins using a backup site before launching on your main WordPress.Cause #4: Problems with themesJust like the white screen of death caused by plugins above, disabling the theme can resolve any WSOD problems that are theme-related. The following are some common causes and s olutions:a) Problems when installing a new themeNew themes can cause a conflict with existing plugins. In this case, deactivate the newly installed theme, which will cause WordPress to revert to your automatic default theme. Ensure that the default theme hasnt already been deleted. If so, upload it back to your themes folder within wp_content/themes.To disable the theme, follow the same procedure described above for plugins, except this time working with the wp_content/themes folder rather than the plugins folder. Rename the specific themes folder, which automatically deactivates the theme.b) Problems with badly coded themesA major WordPress update oftentimes can drive poorly coded themes out. Poorly-coded or outdated themes will often not work once the latest WordPress update is installed.If you notice that the white screen of death in WordPress appeared immediately / soon after conducting an update, your old theme is mostly likely to be the reason behind it. Deactivating your them e as described above could turn things back to normal.c) Problems with theme modificationWordPress isnt a fan of buggy coding. Its proper working depends on a set of well-built objects operating in harmony. If one of those parts is missing or malfunctions, your WordPress will fail to work, resulting in the WSOD.Themes made by reputable theme shops (shameless plug) and those found in the WordPress.org repository are comprehensively tested for any defects. If your white screen of death in WordPress comes after installing any of such themes, the problem could be a plugin-theme conflict.Modifying or updating themes by hand could cause occurrence of improper coding, which is the heart of most WSOD problems. Try to replace the modified file with an old copy from your backup. Otherwise, you should download and reinstall original theme files.Cause #5: Going above the allowable memory limitThis is a classic indication that your site has grown beyond what your current hosting provider gives y ou. Higher amounts of traffic to your site demand higher memory limits, so you should plan to upgrade accordingly.Start by increasing your PHP memory allocation by adding or editing this line in your wp-config.php file:define('WP_MEMORY_LIMIT', '64M');For shared hosts, a memory limit of 64MB is sufficient. Consult the hosting provider if the problem persists after making this alteration.Cheap web hosting can also come at the expense of quality. Such providers want to ensure that they get as many customers within a single server as they can. Therefore, the resources allocated to every client are very limited, for example RAM. If you cant increase your memory limit, youll need to upgrade to the next plan to stop the white screen of death in WordPress from occurring.In the end, most WordPress users and admins will be faced with the infamous WSOD at one point or another in their lives. This problem wont arise from the WordPress core itself, but with using themes and plugins not coded wi th WordPress best practices in mind, user errors, or hosting limitations.If you dont want to worry all that much about this white screen of death, you should first go for quality WordPress hosting provider. A good company will sort out any potential problems as they arise, ensuring that your downtime is kept at a minimum.Its important to stay positive and remember that theres a solution to every situation that you face.