BLOG

Introduction – when a simple update breaks the whole site

Updates are supposed to make your WordPress site more secure and more stable, but in practice they sometimes have the opposite effect. After clicking the update button you may suddenly end up with a completely unusable site. Visitors see a blank page or a cryptic error message, and you might not even be able to log in to the admin dashboard.

The key is not to panic and not to start deleting plugins and themes at random. Instead you should take a structured approach: create backups first, then investigate, then fix the root cause.

Step 1 – create full backups even if the site is already broken

Before touching anything on the server, make sure you have at least one complete backup of both files and database. Even a broken state can be valuable, because you can roll back to it if a later repair attempt goes wrong.

• Download all WordPress files via FTP, using a client such as FileZilla.
• Export the WordPress database as an SQL file via phpMyAdmin.
• If your hosting offers it, create a full account backup in cPanel and save it locally and to an external drive.

Step 2 – check for a stuck .maintenance file

If the update process was interrupted or timed out, WordPress may leave a file called .maintenance in the web root. In that case the site can stay in a semi permanent maintenance mode.

• Connect via FTP to the document root of your site.
• Look for a file named .maintenance and delete it.
• Reload the site in your browser.

If the white screen or maintenance message disappears, the problem was only a stuck update process.

Step 3 – repair WordPress core files without losing content

When core files are corrupted during an update, replacing them with a clean copy is often the fastest fix. You can do this without touching your content and configuration.

1. Download the latest WordPress package from the official site.
2. Extract the ZIP file on your computer.
3. Delete the wp content folder from the extracted copy so that your own themes, plugins and uploads stay untouched.
4. Upload the remaining files to your server via FTP and overwrite the existing core files.

Step 4 – identify plugin conflicts after the update

Many update related crashes are caused by plugins that are not compatible with the new WordPress or PHP version.

• Rename the wp content/plugins directory to plugins disabled to deactivate all plugins at once.
• Test the front end and the admin area.
• If the site loads now, re enable plugins one by one by renaming their folders back to the original names until the error returns.

Step 5 – test with a default theme

If disabling plugins does not solve the issue, the active theme may be the culprit.

• Rename the active theme folder inside wp content/themes.
• WordPress will try to switch to a default theme such as Twenty Twenty Four.
• If the site works with the default theme, the custom theme needs to be reviewed by a developer.

Step 6 – repair database issues

Some updates include database migrations. If these fail half way through, tables can become inconsistent or marked as crashed.

• Use phpMyAdmin to run a repair on all tables in the WordPress database.
• Optionally enable the built in WordPress repair page by adding WP_ALLOW_REPAIR to wp config and visiting the repair URL.

Step 7 – verify PHP version and memory limits

A plugin or theme may fail under a newer PHP version or under too strict memory limits. Use your hosting control panel to check the current PHP version and adjust it if necessary, and consider increasing the memory limit to a more generous value for a busy site.

Step 8 – when to call in a professional

If you have covered all these steps and the site still does not behave correctly, it is a good moment to contact a professional with WordPress and server experience. Thanks to your careful groundwork they will be able to analyse the problem much faster and with lower risk of data loss.

Useful reference links

• Updating WordPress – official guide: https://wordpress.org/support/article/updating-wordpress/
• General WordPress support and documentation: https://wordpress.org/support/
• FileZilla FTP client (free): https://filezilla-project.org/
• phpMyAdmin: https://www.phpmyadmin.net/