A WooCommerce checkout rarely breaks with a bang. More often a plugin or theme update goes in overnight, the shop still looks fine, and the Place order button quietly stops working. You find out days later, from a customer email or a sales report that suddenly shows zero.
This guide covers the usual causes, how to find and fix the problem quickly, and how to make sure you hear about the next one in minutes, not days.
Why checkout breaks after an update
Checkout is the busiest place in WooCommerce. Payment gateways, shipping, tax, coupons, extra fields, anti-spam and caching all hook into the same few steps. When one of them changes, the others can trip over it. The most common causes:
- A plugin update with a PHP fatal error, often a function that was renamed or removed, or a new minimum PHP version.
- The payment gateway plugin changed its settings, its API version, or how it loads its scripts.
- Block checkout versus classic checkout. Many plugins only support one of them. A plugin can work on the old
shortcode and silently do nothing on the newer Checkout block, or the other way round. - Caching or optimisation (minify, defer, combine JavaScript) breaking checkout scripts or caching the cart and checkout pages.
- A security plugin or firewall blocking the Store API (
/wp-json/wc/store/v1/) that the block checkout depends on. - A theme update overriding WooCommerce templates that are now out of date.
How to find the cause in 15 minutes
- Place a test order yourself in a private browser window, logged out, the way a customer would. Note exactly where it fails: adding to cart, loading checkout, shipping rates, or the Place order step.
- Check WooCommerce › Status › Logs for a
fatal-errorslog from today. It usually names the plugin file that crashed. - Open the browser console (F12) on the checkout page. Red JavaScript errors point to a script that a plugin or an optimisation setting broke.
- Check WooCommerce › Status for outdated template overrides in your theme.
- Look at what changed. Which plugins or themes were updated in the last 24 hours? That short list is almost always where the answer is.
How to fix it
Roll back the update that caused it
If a single update is to blame, putting the previous version back is the fastest fix. Your store is selling again within minutes, and you can update properly once the plugin author fixes it. Keep the previous zip of important plugins, or use a tool that keeps it for you.
Test on staging first, then update live
For stores where checkout is the business, update on a staging copy first and run a test order there. Most good hosts include one-click staging.
Exclude checkout from caching and script optimisation
Cart, checkout and My Account should never be page-cached, and checkout scripts should be excluded from combine, defer and delay settings. Most cache plugins have a WooCommerce preset for this; make sure it is switched on.
Catch the next one in minutes, not days
The real damage is not the bug itself but how long nobody notices it. Uptime monitors don’t help here: they only check that the home page loads, and a broken checkout returns a perfectly normal page. To know your checkout works, something has to actually go through it.
You can do that by hand: a test order after every update, then cancel and refund it. It works, but it is easy to forget, especially when plugins update automatically at night.
That gap is why we built Store Guardian. It places a real, hidden test order on your store every hour and right after every update, on block and classic checkout, then removes it and puts the stock back. If checkout fails, you get an alert by email, Slack or Telegram naming the update that caused it, and one click restores the version that worked. Customers never see the test orders and get no emails.
Quick checklist
- Place a logged-out test order after every plugin, theme or WooCommerce update.
- Keep the previous version of your payment, shipping and checkout plugins.
- Never cache cart, checkout or My Account.
- Make sure your firewall allows
/wp-json/wc/store/v1/if you use the block checkout. - Check WooCommerce › Status › Logs weekly for fatal errors.
- Automate the test order so a broken checkout cannot go unnoticed overnight.
Need a hand with a checkout that is broken right now? Tell us what happened and we will take a look.
