TL;DR
Most common WooCommerce problems involve checkout failures, payment errors, missing order emails, slow performance, plugin conflicts, or outdated software. The right fix depends on identifying the cause rather than changing settings at random.
- Start with the symptoms: Check when the issue occurs, which part of your store is affected, and whether it started after an update or configuration change.
- Troubleshoot safely: Review WooCommerce settings and error logs, and use a staging site to test changes that could disrupt your live store.
- Know when to get help: If checkout or payments are failing, orders are affected, or the problem keeps returning, professional WooCommerce support can help you investigate and resolve the underlying issue.
This guide covers 10 common WooCommerce problems, what may cause them, and practical steps to troubleshoot them.
Before troubleshooting: Protect your live WooCommerce store
1. Check whether orders and payments are still being recorded.
Go to WooCommerce → Orders and inspect recent orders, their statuses, and order notes. If a customer reports a failed payment, check the transaction in your payment provider’s dashboard before asking them to try again. A payment may have succeeded even when the order status wasn’t updated correctly.
2. Review WooCommerce logs and system status.
Open WooCommerce → Status → Logs and look for relevant errors around the time the problem occurred. Depending on the issue and available logging, these may include fatal PHP errors or payment gateway messages.
Under WooCommerce → Status → System Status, review your server environment, active software versions, and outdated template overrides. A warning is useful diagnostic information, but it doesn’t automatically identify the cause.
3. Identify what changed before the issue appeared.
4. Test potentially disruptive changes away from your live store.
Important: If customers are being charged but their orders remain pending or failed, stop repeated payment testing until you’ve checked the corresponding transactions. Otherwise, you risk creating duplicate charges.
10 Common WooCommerce Problems and How to Fix Them
1. WooCommerce Checkout Not Working
How to troubleshoot:
1. Identify the checkout type. Open the page assigned under WooCommerce → Settings → Advanced. Check whether it uses the Checkout block or the classic woocommerce_checkout shortcode. This determines which requests need investigating.
2. Check for failed requests. Open your browser’s Developer Tools → Network tab and reproduce the issue using a safe test environment. Classic Checkout typically uses wc-ajax requests, while Checkout Block uses WooCommerce Store API endpoints under /wp-json/wc/store/. Failed requests and their responses can help narrow down the cause.
3. Review caching and plugin conflicts. Make sure checkout pages and related dynamic requests aren’t being incorrectly cached. If the problem started after an update, investigate the affected plugin or theme on staging rather than disabling essential functionality on your live store.
4. Check orders before retrying payments. If checkout appears to fail after clicking Place Order, inspect WooCommerce → Orders and your payment provider’s transaction records. The payment or order may already exist.
When to seek help: If checkout continues to fail, requests return server errors, or customers are charged without their orders updating correctly, further technical investigation is needed before making additional changes.
2. WooCommerce Payment Gateway Failures
How to troubleshoot:
1. Check the affected order. Go to WooCommerce → Orders, open the order, and review its status and order notes. Look for decline reasons, transaction IDs, or gateway error messages.
2. Verify the transaction with your payment provider. Check the corresponding payment in Stripe, PayPal, WooPayments, or whichever gateway you use. If the payment succeeded but WooCommerce still shows Pending payment or Failed, investigate the status synchronization before retrying the charge.
3. Review payment gateway logs. Go to WooCommerce → Status → Logs and select the relevant gateway log, if available. Some payment plugins require logging to be enabled in their settings before they record detailed errors.
4. Check gateway configuration and notifications. Verify that the payment method is enabled and correctly configured. If payments succeed but order statuses don’t update, inspect the gateway’s webhook or callback configuration using its official documentation.
When to seek help: If multiple customers experience payment failures, successful transactions aren’t reflected in WooCommerce, or gateway errors continue after basic checks, the integration needs further investigation.
3. WooCommerce Order Emails Not Sending
Start by checking an affected order under WooCommerce → Orders. If payment was completed but the order remains Pending payment, investigate why its status wasn’t updated. WooCommerce may not have triggered the expected confirmation email.
If the order status is correct, check the following:
1. Email settings: Open WooCommerce → Settings → Emails and confirm that the relevant notification is enabled and has the correct recipient.
2. Transactional email logs: In supported WooCommerce versions, go to WooCommerce → Status → Logs and look for the transactional-emails log. It can show whether an email was sent, failed, disabled, or skipped.
3. Email delivery: If WooCommerce handed the message to the mail system successfully but the recipient didn’t receive it, check your mail provider’s delivery logs, spam filtering, and SPF, DKIM, and DMARC configuration.
4. WooCommerce Shipping and Tax Issues
When shipping options are missing
Go to WooCommerce → Settings → Shipping → Shipping zones and check whether the customer’s address matches the correct zone. Make sure that zone contains an enabled shipping method.
Zone order matters: WooCommerce uses the first matching zone. A more general zone placed above a specific one may prevent the intended shipping method from appearing.
When shipping costs or taxes are incorrect
1. Shipping rates: Check the rates, conditions, and restrictions configured for the matching shipping method. Free shipping, for example, may depend on a minimum order amount or coupon.
2. Tax calculations: Under WooCommerce → Settings → Tax, verify which address is used to calculate taxes, whether prices include tax, and which tax rates apply.
3. Location-specific results: Test the checkout using an affected customer’s shipping address and cart contents. Different destinations or product tax classes may produce different totals.
5. Slow WooCommerce Store Performance
Start by identifying where the slowdown happens.
1. Slow product pages: Check oversized images, unnecessary scripts, and resource-heavy product extensions.
2. Slow cart or checkout: Review server performance, payment integrations, and caching configuration. These pages contain customer-specific information and shouldn’t be treated like ordinary static pages.
3. Slow WooCommerce admin: Check WooCommerce → Status → Scheduled Actions for repeatedly failing or backlogged tasks. If the issue persists, investigate database activity and server resources.
6. WooCommerce Plugin and Theme Conflicts
7. Outdated WooCommerce Templates
What should you check?
Open WooCommerce → Status → System Status and scroll to the Templates section. You’ll see which template files your theme overrides and whether WooCommerce reports them as outdated.
Don’t simply replace customized template files with new ones. Doing so can remove modifications your store depends on. Test the updated templates before deploying them to your live store.
8. Blurry or Incorrect WooCommerce Product Images
1. Original image quality: Open the image in Media Library and inspect its dimensions. WooCommerce recommends images of at least 800 × 800 pixels for most product displays, although larger layouts may require higher resolution.
2. Theme image settings: Check Appearance → Customize → WooCommerce → Product Images, if your theme provides these controls. Make sure the image width and cropping settings match your product layout.
3. Generated thumbnails: If you’ve changed themes or image sizes, go to WooCommerce → Status → Tools and use Regenerate shop thumbnails to recreate the required image sizes.
9. WooCommerce White Screen of Death (WSOD)
Where to look first:
1. WordPress recovery email: Check the site’s administrator inbox for a technical issue notification. If WordPress detected a fatal error, the email may identify the affected plugin or theme and provide a recovery link.
2. WooCommerce fatal-error logs: If you can access your dashboard, open WooCommerce → Status → Logs and look for a fatal-errors log. Check the timestamp, error message, and referenced file.
3. Hosting error logs: If the WordPress dashboard is inaccessible, use your hosting control panel to inspect PHP error logs or ask your hosting provider to retrieve the relevant entries.
10. WooCommerce 500 Internal Server Error
To narrow down the cause:
1. Identify the affected request. Does the error appear across the entire store or only during a specific action? A 500 response during checkout may point to a failed server-side request rather than a problem with the whole website.
2. Check server error logs. Look for entries matching the time and URL of the failed request. Your hosting provider can help retrieve these logs if you don’t have direct access.
3. Review recent server changes. If the error began after changes to PHP settings, server configuration, or .htaccess rules, investigate those changes before modifying anything else.
When to Get Professional WooCommerce Support
- Customers cannot complete purchases. Checkout failures or unavailable payment methods are affecting transactions.
- Payments and orders don’t match. A payment succeeds, but the corresponding WooCommerce order remains pending or failed.
- An issue keeps returning. A temporary fix works, but the same problem reappears after an update or configuration change.
- Troubleshooting requires code or server changes. The problem involves PHP errors, custom integrations, or modifications that could disrupt your live store.
If you’ve identified a problem but aren’t confident about making the necessary changes, Kiwistic offers WooCommerce support for investigating and resolving store issues.
How to Prevent Recurring WooCommerce Problems
- Controlled updates: Test significant WooCommerce, theme, and plugin updates on staging before applying them to your live store.
- Regular backups: Keep recoverable copies of your files and database, and verify that your backup process works.
- Checkout testing: After updates, confirm that customers can add products to their cart, complete a test purchase, and receive the expected emails.
- Error monitoring: Review recurring errors and failed scheduled actions before they affect important store operations.
These checks won’t prevent every technical issue, but they can help you identify problems earlier and reduce the risk of unexpected disruptions.
For businesses that need ongoing help with updates, backups, and technical maintenance, explore Kiwistic’s WordPress maintenance plans.


