Why does WordPress show a white screen and how can you fix common errors?

WordPress problems often arise from faulty plugins or themes, code and database errors, incorrect server settings, corrupted files or caching. Common fixes include disabling sus­pi­cious ex­ten­sions, checking logs, file per­mis­sions and server limits, and restoring via backup or recovery mode.

1. WordPress white screen of death

In the past, serious WordPress errors often resulted in nothing more than a com­pletely white page, giving rise to the rather dramatic term ‘WordPress white screen of death’. Today, WordPress is much more user-friendly and often displays specific error messages or provides access to recovery mode.

There are several possible causes of the WordPress white screen of death, including faulty plugins, PHP issues and various coding or database errors. It is therefore important to identify the exact cause before at­tempt­ing to fix the problem.

Recovery mode for troubleshoot­ing critical errors

Since WordPress 5.2, the CMS has included a built-in recovery mode that is auto­mat­ic­ally triggered by certain critical errors. If a serious PHP error occurs, WordPress may display a general error message instead of a white page and send an email to the ad­min­is­trat­or address. This email contains a special recovery link that allows you to access the backend despite the error. WordPress then indicates which plugin or theme is causing the problem and gives you the option to de­ac­tiv­ate it directly.

Recovery mode only works if WordPress can detect and intercept the error. If the PHP error occurs too early in the loading process, no recovery email may be sent. In this case, you need to troubleshoot the problem manually via FTP or the file manager, as described in the following sections.

Error source 1: plugins

The WordPress white screen of death is often triggered by one of the following actions:

• You have activated a WordPress plugin that is not working correctly.
• You have changed the settings of an active plugin.
• You have modified the code of an active plugin.

If you have recently made one of these changes, open the plugins page in WordPress and de­ac­tiv­ate the plugin you last modified. In many cases, this is enough to resolve the problem and remove the WordPress white screen.

If the WordPress admin page is no longer ac­cess­ible because of the white screen, you can use WordPress recovery mode, provided you have received the cor­res­pond­ing email. If this is not possible, you need to access your WordPress files via FTP or your hosting provider’s file manager and de­ac­tiv­ate the plugins manually. Proceed as follows:

1. Open the directory where your WordPress files are stored.
2. Open the wp-content folder.
3. Locate the plugins folder inside wp-content.
4. Rename the folder to de­ac­tiv­ate all plugins at once.

Error source 2: code errors

If the error is not caused by a plugin, it may be because you have modified the functions.php file or another PHP file using the WordPress theme editor. In such cases, WordPress often displays a specific error message or switches the website to recovery mode. A typical message might look like this:

Parse error: syntax error, unexpected end of file in /home/name/public_html/wordpress/wp-content/themes/your_theme/functions.php on line 231

This means that there is an error in the code, which may prevent the selected WordPress theme or WordPress framework from being displayed correctly. In this case, you need to restore a working version of the affected file.

If the WordPress admin page is not ac­cess­ible, you can replace the faulty file via FTP or your hosting provider’s file manager:

1. Open the directory where your WordPress files are stored.
2. Open the wp-content folder and then the themes folder.
3. Open the folder of your active theme.
4. Locate the affected file.
5. Upload a working version of the file, either from a backup or from the theme’s original files.

Al­tern­at­ively, you can de­ac­tiv­ate the entire theme by renaming its folder or tem­por­ar­ily switching to a different theme. If a default WordPress theme is installed, WordPress can then fall back to it. Af­ter­wards, return to your browser and refresh your website.

When the cause of the error is unclear

Sometimes, the WordPress white screen of death appears for no obvious reason: you have not modified any plugins or changed your theme’s code. In such cases, it is best to troubleshoot the problem sys­tem­at­ic­ally. One useful approach is to enable WP_DEBUG, which can display specific error messages and help you identify faulty files or lines of code.

Open the wp-config.php file in the main directory of your WordPress in­stall­a­tion and add the following lines:

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

With WP_DEBUG_LOG, all WordPress errors are recorded in the wp-content/debug.log file. WP_DEBUG_DISPLAY should remain set to false so that errors are not displayed publicly on the website. This is par­tic­u­larly important on live websites, as debug output may contain sensitive in­form­a­tion such as database paths or server con­fig­ur­a­tion details. You can then analyse the errors directly in the log file, which can be accessed via FTP or your file manager. Once you have finished troubleshoot­ing, de­ac­tiv­ate debug mode again by setting all three entries to false.

In addition to plugins, there are several other possible causes of the display error that may not be im­me­di­ately obvious:

• Caching: If you use a caching plugin, clearing the website cache may resolve the problem. If you cannot access the WordPress admin page to clear the plugin cache, you can also try clearing your browser cache.
• Corrupted files: WordPress files may have become corrupted, for example due to malware or an in­com­plete update. Contact your hosting provider if you need help dia­gnos­ing the problem.
• Server issues: An over­loaded or tem­por­ar­ily un­avail­able server can also cause a WordPress white screen. Check your email for no­ti­fic­a­tions from your hosting provider or contact their support team.

2. Internal server error with a 500 status code

The error message 500 Internal Server Error is one of the most common server errors. In WordPress, it is often caused by plugins or problems with themes. Other possible causes include a corrupted .htaccess file or in­suf­fi­cient PHP memory. An internal server error can also affect the WordPress admin page while the rest of the website continues to work normally.

Error source 1: corrupted .htaccess file

A common cause of the ‘500 Internal Server Error’ message is a corrupted .htaccess file. To check whether this file is causing the problem, log in to your server via FTP or your hosting provider’s file manager. Navigate to the WordPress root directory and locate the .htaccess file. Tem­por­ar­ily rename the file and then reload your website. If the site works again, the .htaccess file was most likely the cause.

Next, create a new .htaccess file by logging in to the WordPress admin area and going to ‘Settings’ → ‘Permalinks’. Save the settings again without making any changes. WordPress will then auto­mat­ic­ally generate a new .htaccess file with the default rewrite rules.

Error source 2: in­suf­fi­cient PHP memory

A 500 Internal Server Error can occur if WordPress or a plugin requires more PHP memory than the server provides. The error log may offer clues, for example messages such as ‘Allowed memory size exhausted’.

To in­vest­ig­ate the problem, enable WordPress debugging with log output so that errors are recorded in a file. If a memory issue is confirmed, in­creas­ing WP_MEMORY_LIMIT in the wp-config.php file may help. You should also check your plugins and themes, as excessive memory usage is often caused by in­di­vidu­al ex­ten­sions.

Error source 3: corrupted core file

Although it is re­l­at­ively uncommon, a corrupted WordPress core file can also cause an internal server error. In this case, replacing the affected core files with fresh copies can help eliminate the source of the problem.

Connect to your website via FTP or your hosting provider’s file manager. The wp-admin and wp-includes folders contain WordPress core files and can generally be replaced with fresh copies from a clean WordPress in­stall­a­tion. This should not affect your personal WordPress cus­tom­isa­tions, provided you have not manually modified files in these folders. The wp-content folder, however, contains your themes, plugins and uploads. Do not replace or delete this folder, as doing so could remove important website content.

If other troubleshoot­ing steps have failed, download a fresh copy of WordPress and replace the core files manually. Before doing so, back up your existing wp-config.php file and database, and make sure that the wp-content folder remains unchanged.

3. Error es­tab­lish­ing a database con­nec­tion

The message ‘Error es­tab­lish­ing a database con­nec­tion’ means that WordPress is unable to connect to the database. Without this con­nec­tion, the website cannot load its content or provide access to the WordPress admin area correctly. Common causes include incorrect login details in wp-config.php, an incorrect database host or a server-side issue.

Error source 1: incorrect con­nec­tion settings

First check the login details in your wp-config.php. These four entries are crucial:

define( 'DB_NAME', 'database_name' );
define( 'DB_USER', 'database_user' );
define( 'DB_PASSWORD', 'password' );
define( 'DB_HOST', 'localhost' );

Even a small typo in the database name, username, password or host can prevent WordPress from es­tab­lish­ing a con­nec­tion. A common example is failing to update the host after a server migration or for­get­ting to change the password.

The value for DB_HOST is often localhost, but this is not always the case. Some hosting providers use a specific hostname or address for the MySQL database server. In these cases, you need to enter the value provided by your host. Depending on the hosting setup, you may also be able to use the IP address of the database server instead of its hostname.

Error source 2: your database is corrupted

This error is not the same as ‘Error es­tab­lish­ing a database con­nec­tion’, but it is closely related. In some cases, the frontend of your website may still work normally even though an error message appears in the WordPress admin area. This can happen when one or more database tables are un­avail­able or corrupted and the database needs to be repaired.

Open the wp-config.php file and locate the section con­tain­ing your database name, username, password and host. Then add the following line:

define('WP_ALLOW_REPAIR', true);

Save the wp-config.php file and upload it via FTP. Then open the following URL: https://www.your-site.net/wp-admin/maint/repair.php. On this page, you will see two options: ‘Repair Database’ and ‘Repair and Optimize Database’. Before con­tinu­ing, make sure you have created a complete backup of your database.

Select ‘Repair Database’ and wait for the repair process to finish. Then open your website in a new browser tab and check whether it is displayed without any errors.

Error source 3: the MySQL database server is down

This scenario can occur when your hosting provider’s server reaches its capacity. If your website receives a sudden surge in traffic, the database server may become over­loaded. With some hosting providers, a large number of websites share the same server. If one of these sites ex­per­i­ences a sig­ni­fic­ant traffic spike, it can affect other websites on the same server.

To rule out a server-side issue, contact your hosting provider’s support team and ask them to check the status of the database server. There may be a technical problem, or the provider may be carrying out scheduled server main­ten­ance that has not yet been com­mu­nic­ated to you.

4. Con­nec­tion timed out

The message ‘Con­nec­tion timed out’ means that a request could not be completed within the permitted time. In WordPress, this usually occurs when the server, a plugin, a theme or an external service takes too long to respond.

Error source 1: server is over­loaded

One of the most common causes is an over­loaded server. This can happen with shared hosting, too many sim­ul­tan­eous requests or resource-intensive processes. If the server doesn’t respond quickly enough, the browser or an internal WordPress process will abort with a timeout.

Error source 2: faulty plugins or themes

Plugins and themes can cause timeouts if they trigger too many queries, start faulty processes or call external services that don’t respond in time. Tem­por­ar­ily de­ac­tiv­ate all plugins and check whether the error dis­ap­pears. Then re­act­iv­ate them one by one. If necessary, also switch tem­por­ar­ily to a default theme.

Error source 3: exhausted PHP memory limit

If the available PHP memory is in­suf­fi­cient, processes may stop un­ex­pec­tedly or take an unusually long time to complete. In such cases, in­creas­ing the WordPress memory limit in wp-config.php may help. WordPress uses a default memory limit of 40 MB for single-site in­stall­a­tions and 64 MB for multisite in­stall­a­tions, so any manually defined value should generally be higher:

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

However, with shared web hosting, the memory limit can usually only be increased up to a certain level. If you need a higher limit, you may have to contact your hosting provider and ask them to increase it. Bear in mind that some shared hosting plans impose a re­l­at­ively low PHP memory limit.

Error source 4: PHP maximum execution time too low

A timeout can also occur if a PHP script takes longer to run than the server allows. In such cases, you may see a message such as ‘Maximum execution time of 30 seconds exceeded’. The relevant setting is max_execution_time, which can be con­figured in php.ini. It de­term­ines how many seconds a script is allowed to run before it is ter­min­ated. In web en­vir­on­ments, the default value is often 30 seconds.

If your website regularly times out during certain op­er­a­tions, such as imports, large uploads, updates or resource-intensive plugins, in­creas­ing this value may help. For example, the setting in php.ini might look like this:

max_execution_time = 60

5. WordPress doesn’t save changes

If changes in WordPress are not im­me­di­ately visible, this does not ne­ces­sar­ily mean they were not saved. In many cases, an older cached version of the website is still being displayed. Common causes include the browser cache, a caching plugin, server-side caching by your hosting provider or a CDN.

Solution 1: fully reload the page

Browsers store content in their cache so that pages load faster on sub­sequent visits. Try per­form­ing a hard refresh of the page. On Windows, this usually works with [Ctrl] + [F5] or [Ctrl] + [Shift] + [R], while on a Mac you can usually use [Cmd] + [Shift] + [R].

Solution 2: clear the browser cache

If a hard refresh does not help, clear the browser cache com­pletely. This is useful if the browser is still loading older versions of files such as stylesheets, JavaS­cript or images. Then reopen the page and check whether the changes are visible. This step is par­tic­u­larly important after editing CSS, theme files or the website layout.

Solution 3: clear the cache in WordPress or in the hosting

If the old version is still visible, the problem may no longer be caused by the browser but by caching on the server. Many WordPress websites use ad­di­tion­al caching layers, such as caching plugins, server-side caching from the hosting provider or a CDN. These systems serve cached versions of pages to improve loading times, which means changes may not appear im­me­di­ately even though they have been saved correctly.

Clear the following caches in this order:

• the cache of your caching plugin
• the server-side cache provided by your hosting provider
• the CDN cache, if you are using a CDN

Many hosting providers offer options such as ‘Clear cache’, ‘Purge cache’ or ‘Flush cache’, either in the customer control panel or directly in the WordPress dashboard.

Solution 4: check that changes are saved in the editor

If the page is not only showing outdated content but changes are also not being applied in the editor itself, there may be a problem with the saving process. This is par­tic­u­larly relevant when using the block editor, as WordPress processes content there via JavaS­cript and the REST API. If an error occurs during this process, changes may not be saved correctly, even if they initially appear to have been.

In this case, tem­por­ar­ily de­ac­tiv­ate all plugins and check whether the problem still occurs.

Solution 5: check upload and path

If you have made changes directly to files, such as CSS, template or theme files, also check that the modified file has actually been uploaded to the server and is stored in the correct folder. It is quite common to edit the correct file locally while an older version remains on the server, or to overwrite the wrong file ac­ci­dent­ally.

This is par­tic­u­larly worth checking if you use a child theme or have several versions of a theme stored on the server. In these cases, make sure the file path is correct.

6. Ongoing main­ten­ance mode after an upgrade

If WordPress gets stuck during an update, your website may continue to display the message: ‘Briefly un­avail­able for scheduled main­ten­ance. Check back in a minute’. The cause is usually a file called .maintenance, which WordPress auto­mat­ic­ally creates in the root directory during an update. Normally, this file is deleted once the update is complete. If that does not happen, the website remains stuck in main­ten­ance mode.

In most cases, the solution is simple:

1. Log in via FTP or your hosting provider’s file manager.
2. Open the root directory of your WordPress in­stall­a­tion, i.e. the folder con­tain­ing the wp-config.php file.
3. Delete the .maintenance file and then reload the website.

If the problem persists, the main­ten­ance file was probably not the only issue and the update itself may have failed. In this case, check the most recently updated plugin, theme or, if ap­plic­able, WordPress core, and reinstall or update it manually. Server logs or WordPress error logs can also help identify why the update was in­ter­rup­ted.

7. Syntax error

A syntax error is usually caused by a small but important mistake in the code syntax. A missing comma or an incorrect bracket can be enough to break an entire script. This type of error often occurs after code has been added manually to a theme file, functions.php, a plugin or a custom snippet. In many cases, the error message iden­ti­fies the affected file and line number, helping you locate the problem quickly.

To fix the syntax error, you need to correct or remove the faulty section of code. The easiest way to do this is via FTP, your hosting provider’s file manager or another method that gives you direct access to the affected file.

Since WordPress 5.2, recovery mode can also help. In many cases, instead of dis­play­ing a WordPress white screen, WordPress shows an error message and sends a recovery link to the ad­min­is­trat­or email address.

8. Automatic update failure

WordPress auto­mat­ic­ally installs many minor and security-related updates in the back­ground. If one of these updates fails, the website may become stuck in main­ten­ance mode or display a message such as ‘Update failed’.

The first step is usually straight­for­ward: delete the .maintenance file from the root directory of your WordPress in­stall­a­tion, i.e. the folder con­tain­ing wp-config.php. Then reload the website. If the site works again, check which update failed, whether it was a plugin, a theme or WordPress itself, and try running the update again. If the automatic update fails re­peatedly, a manual update is usually the safer option.

9. Problems uploading images in WordPress

If you cannot upload images in WordPress, the problem is not ne­ces­sar­ily caused by WordPress itself. Common causes include incorrect file per­mis­sions, re­strict­ive server limits, image-pro­cessing issues or plugin conflicts. Modern image formats such as WebP and AVIF can also cause problems if the required server libraries are not con­figured correctly.

It is usually worth checking ‘Tools’ → ‘Site Health’ → ‘Info’ first. There, you can find details about media pro­cessing, file system per­mis­sions and the server en­vir­on­ment. This can help you determine whether WordPress is able to process images correctly or whether there are signs of a server-side problem.

Solution 1: Check file per­mis­sions

If you suspect that file per­mis­sions are causing the problem, connect to your website via FTP, SFTP or your hosting provider’s file manager and open the /wp-content/ folder. Inside, you will find the /uploads/ directory.

First, check the per­mis­sions for the uploads directory and its sub­folders. For dir­ect­or­ies, 755 is usually the ap­pro­pri­ate value. Then check the files within these folders. For files, 644 is generally suitable. This com­bin­a­tion is commonly used for standard WordPress in­stall­a­tions.

Solution 2: Server settings

Another common cause of image upload problems is server limits that are set too low. This applies in par­tic­u­lar to the PHP values upload_max_filesize, post_max_size, memory_limit and the maximum execution time. These settings determine how large uploaded files can be and how many resources are available for image pro­cessing. With high-res­ol­u­tion images or when WordPress auto­mat­ic­ally generates several image sizes, the default limits of some hosting packages may not be suf­fi­cient.

First, check your hosting control panel or PHP con­fig­ur­a­tion to see the current values. If uploads fail or error messages appear, increase the limits gradually. The following values can serve as a guide:

• upload_max_filesize: at least 64 MB, or prefer­ably 128 MB or more for image-heavy websites or high-res­ol­u­tion photos
• post_max_size: at least as high as upload_max_filesize
• memory_limit: at least 256 MB

If you cannot change these settings yourself, contact your hosting provider and ask them to adjust the values ac­cord­ingly.

Solution 3: Modern image formats

If JPG or PNG files work but WebP or AVIF files do not, the problem is often related to image pro­cessing on the server rather than the upload folder. WordPress has supported WebP natively since version 5.8 and AVIF since version 6.5, so no ad­di­tion­al plugin is required. However, whether these formats can actually be used depends on the hosting en­vir­on­ment.

For AVIF, either Imagick or LibGD with AVIF support must be enabled on the server. In addition, PHP 8.1 or higher is required for the GD extension to process AVIF natively. You can check whether the necessary support is available under ‘Tools’ → ‘Site Health’ → ‘Info’ → ‘Media Handling’. If it is missing, errors may occur when uploading images or when WordPress auto­mat­ic­ally generates ad­di­tion­al image sizes.

10. Sidebar appears below the main content

If the sidebar in WordPress appears below the main content instead of beside it, there is usually a layout issue. This can make the page look cluttered or broken, but in most cases the correct layout can be restored with a few ad­just­ments.

However, this is not always an actual error. Many modern themes de­lib­er­ately move the sidebar below the main content on smaller screens to improve read­ab­il­ity on smart­phones. First, check whether the issue also occurs on desktop devices or only at narrower screen widths.

Common causes of the problem

A common cause is faulty HTML code, for example when elements are not closed correctly. This can disrupt the page structure and prevent the sidebar from being po­si­tioned properly beside the main content. Incorrect or con­flict­ing CSS rules can cause similar problems. If the main content and sidebar together require more space than the layout provides, the sidebar may be pushed below the content. Possible causes include:

• width values that are too large for the content area or sidebar
• ad­di­tion­al padding or margins
• incorrect max-width values
• incorrect Flexbox or grid settings

Changes to the CSS file or custom CSS can also cause the layout to shift un­ex­pec­tedly.

Another possible cause is the theme or template structure. Modern WordPress themes, par­tic­u­larly block themes, do not always use tra­di­tion­al sidebars and may instead rely on layout blocks or template files. If a ‘Full Width’ template is selected or the sidebar has been removed from the template, it will no longer appear beside the content.

Plugins and page builders can also affect the layout. Tools for per­form­ance op­tim­isa­tion, CSS com­pres­sion or visual page builders may alter how styles are processed and can un­in­ten­tion­ally cause the sidebar to move.

Specific steps to resolve the problem

Narrow down the cause step by step:

1. Check whether the problem only occurs on mobile devices as part of the re­spons­ive design.
2. Check whether a different page template, such as ‘Standard’ instead of ‘Full Width’, is selected.
3. Tem­por­ar­ily de­ac­tiv­ate recently installed plugins or page builders to see whether they are causing the issue.
4. Check any custom HTML code for unclosed elements, for example using an HTML validator.
5. Review your CSS cus­tom­isa­tions, par­tic­u­larly widths, spacing and layout settings.
6. Test whether the problem persists when you switch to a default WordPress theme.

If the sidebar still appears below the content after these steps, check the theme files or contact your hosting provider or the theme developer’s support team.