WordPress & WooCommerce Stuck After an Update? Here's How to Fix It

You updated a plugin, a theme, or WordPress itself — and now something's wrong. Maybe your site says "Briefly unavailable for scheduled maintenance" and won't budge. Maybe the screen is just blank. Maybe the homepage looks fine, but customers can't check out.

None of this means your site is broken for good. Update problems are common, well understood, and — in almost every case — fixable in a few minutes without touching a line of code. This guide walks through the most common issues WordPress and WooCommerce store owners run into after an update, and exactly what to do about each one.

Before anything else: if your hosting provider offers one-click backups (most do, usually under "Backups" or "JetBackup" in your hosting dashboard), take one now. It takes 30 seconds and means whatever you try next, you can always undo it.

1. Stuck in Maintenance Mode

What you'll see: "Briefly unavailable for scheduled maintenance. Check back in a minute" — and it's been a lot longer than a minute.

Why it happens: Every WordPress update creates a small hidden file called .maintenance in your site's root folder, telling WordPress to hide the site while the update runs. Normally it deletes itself the moment the update finishes. If the update gets interrupted — a slow server, a timeout, updating too many plugins at once — that file never gets cleaned up, and the site stays locked even if the update actually completed.

This is especially common on WooCommerce stores specifically, since WooCommerce updates are heavier than a typical plugin update, and on shared or budget hosting that extra load is often exactly what causes the process to stall.

How to fix it:

1. Log in to your hosting account (not WordPress — your hosting provider's dashboard, e.g. cPanel or hPanel)
2. Open File Manager, usually under a "Files" section
3. Navigate to public_html — this is your site's root folder, the same one containing wp-config.php
4. Turn on "Show hidden files" (usually a gear or settings icon in the toolbar) — files starting with a dot are hidden by default
5. Find the file named .maintenance and delete it
6. Refresh your site — it should load normally straight away

2. White Screen (No Error, Nothing Visible)

What you'll see: A completely blank page — no error message, no site, just white.

Why it happens: Usually a plugin or theme conflict, or the server running out of memory partway through the update, leaving some files updated and others not.

How to fix it:

1. In File Manager, go to wp-content/plugins
2. Rename the whole plugins folder to plugins_old — this temporarily disables every plugin at once
3. Reload your site. If it comes back, the problem is a plugin conflict
4. Rename the folder back to plugins, then rename plugin folders one at a time (e.g. woocommerce_old → woocommerce) reloading the site after each one, until you find the plugin causing the issue

3. "There Has Been a Critical Error"

What you'll see: WordPress's own generic error message, sometimes with an option to check your email for more details.

Why it happens: A plugin or theme is using code that's incompatible with your current WordPress or PHP version — often surfacing right after an update.

How to fix it: Same process as the white screen fix above (renaming the plugins folder) — a critical error is nearly always a plugin conflict wearing a different message.

4. Site Loads Fine, But Checkout Is Broken

What you'll see: Your homepage looks completely normal — but customers can't complete a purchase, payments fail, or stock counts look wrong.

Why it happens: This one is specific to WooCommerce stores, and it's the most dangerous because it's invisible unless you actually test the store yourself. A homepage loading proves nothing about whether checkout, payment gateways, or order processing survived the update.

How to fix it:

1. Place a real test order yourself (use a test payment method if your gateway supports one)
2. Check WooCommerce → Status in your dashboard for any flagged warnings
3. If checkout is broken, it's very likely a payment gateway plugin that didn't update cleanly alongside WooCommerce itself — check that plugin's version and changelog specifically
4. If the problem isn't obvious within 10–15 minutes, this is a good moment to bring in help rather than keep guessing — a broken checkout costs you sales every hour it's live

5. Dashboard Won't Load, But the Site Itself Is Fine (or Vice Versa)

What you'll see: Customers can browse normally, but you can't get into /wp-admin — or the reverse, where you can log in but the public site is down.

Why it happens: Usually a caching issue rather than a real break — your site or browser is showing an old, cached version of one part of the site.

How to fix it:

1. Clear your browser cache, or try opening the site in a private/incognito window
2. If you use a caching plugin (WP Rocket, W3 Total Cache, etc.), clear the cache from inside your WordPress dashboard
3. If your host uses server-level caching (common with managed WordPress/WooCommerce hosting), check your hosting dashboard for a "Clear Cache" or "Purge Cache" button

6. It Keeps Coming Back After You Fix It

If you delete the .maintenance file and the site locks up again shortly after, a plugin is very likely regenerating it — which almost always points back to a plugin conflict. Follow the plugin-isolation steps in section 2 above rather than repeatedly deleting the file, since that only treats the symptom.

How to Avoid This Next Time

• Update plugins one at a time, not all at once — bulk updates are the single biggest cause of update-related site crashes on shared hosting
• Read the changelog before updating anything major — takes 60 seconds and often flags a breaking change in advance
• Test on a staging site first if your host offers one, especially before major WooCommerce or WordPress core updates
• Update during quiet hours, not your busiest sales period
• Always test checkout after a WooCommerce update — not just the homepage

When to Call In Help

Most of the fixes above take five minutes and no technical background. But if your store handles real transactions daily, every hour of downtime is lost sales — and some issues (corrupted database tables, a core update that failed halfway through, hosting-level permission problems) go beyond a quick plugin swap.

If you'd rather not be the one troubleshooting a broken checkout at 11pm, Netboost offers ongoing WordPress and WooCommerce maintenance — so updates happen safely, on a schedule, with a real backup in place before anything changes.