WooCommerce
Step-by-step WooCommerce troubleshooting guides.
Trace checkout, payment, order, shipping and product faults with checks that separate store configuration from plugin, theme and gateway problems.
Tutorials
Guides in this topic
A store fault can begin in WooCommerce, an extension, the active theme or an external payment service. Match the symptom first, review recent changes and logs, then test one cause at a time without risking genuine orders.
Checkout
How to fix WooCommerce checkout not working
Fix WooCommerce checkout not working with clear checks for missing payment fields, loading errors, caching and plugin conflicts, then verify a complete order.
Cart
How to fix WooCommerce cart not updating
Fix WooCommerce cart not updating by checking the basket page, mini-cart, cache and cookies. Follow safe tests that preserve customers' active shopping carts.
Payments
How to fix WooCommerce payment gateway errors
Diagnose WooCommerce payment gateway errors using order notes, provider records and logs. Check account connections and verify payments before retrying charges.
Order emails
How to fix WooCommerce order emails not sending
Fix WooCommerce order emails not sending by checking order status, notification settings, mail logs and sender authentication. Verify delivery to a real inbox.
Shipping
How to fix WooCommerce shipping not calculating
Fix WooCommerce shipping not calculating with checks for addresses, zone order, enabled methods and product settings. Diagnose carrier rates and verify totals.
Coupons
How to fix a WooCommerce coupon not working
Fix a WooCommerce coupon not working by checking its error, limits and discount type. Test eligibility, free shipping and custom coupon fields safely.
Product variations
How to fix WooCommerce product variations
Fix WooCommerce product variations that disappear or will not add to cart. Check prices, attributes, stock and selectors without rebuilding products.
Stripe payments
How to fix WooCommerce Stripe payment failed errors
Fix WooCommerce Stripe payment failed errors by checking the charge, connection, authentication and webhooks. Test the repair without charging customers twice.
PayPal payments
How to fix WooCommerce PayPal not working
Fix WooCommerce PayPal not working by checking payment records, missing buttons, account connections and notifications. Follow safe steps for PayPal Payments.
Subscription renewals
How to fix WooCommerce subscription renewal failed errors
Fix WooCommerce subscription renewal failed errors by tracing renewal orders, payment records and scheduled actions. Recover payments without duplicate charges.
Keep troubleshooting
More WordPress how-to guides
Move to another topic when the evidence points beyond this part of WordPress. Each guide keeps the diagnosis focused and the next step reversible.
- Errors WordPress error troubleshooting Critical errors, white screens, database failures, and recovery steps.
- Security WordPress security guides Certificates, mixed content, HTTPS redirects, and hardening basics.
- Plugins WordPress plugin tutorials Install, update, deactivate, and roll back plugins and themes safely.
- Administration WordPress administration guides Backups, migrations, user roles, and safe config changes.
- Performance WordPress performance guides Caching, images, database bloat, and slow admin fixes.
Questions answered
WooCommerce troubleshooting FAQs
Answers about checkout tests, payment records, order emails, shipping rules and safe conflict checks on a live shop.
Where should WooCommerce troubleshooting begin?
Identify the exact step that fails, note the time and affected order, then review WooCommerce status, order notes, logs and recent changes. Check whether the issue affects every customer, one payment method or one product before changing settings.
How can I test WooCommerce checkout safely?
Use an isolated staging copy with the payment provider's sandbox credentials and outgoing customer messages contained. Follow the checkout guide to verify the order as well as the screen. Before any retry, check whether the earlier attempt created a charge or authorisation.
Is a failed payment always a WooCommerce fault?
No. A bank decline, authentication failure or gateway outage can fail without a WordPress fault. Compare the WooCommerce order notes with the gateway transaction record and logs before changing checkout code or credentials.
Why does a WooCommerce order stay pending after payment?
The payment provider can have a charge or authorisation that WooCommerce has not recorded correctly. Compare its transaction with the order notes and notification delivery before requesting payment again. For recurring orders, follow the subscription renewal guide before triggering a manual retry.
Why are WooCommerce order emails not being delivered?
First check whether WooCommerce generated the email and whether the order reached the status that triggers it. Then inspect email logs, recipient settings, SMTP delivery and spam filtering rather than repeatedly resending without a delivery record.
Why are no shipping methods available at checkout?
The customer's address, shipping zone, product class, package weight or cart conditions may not match any enabled rate. Recreate the same basket and address, then trace which zone and method WooCommerce selects.
Why is a WooCommerce coupon not working?
Check its expiry, usage limits, minimum spend, allowed products, customer email restrictions and whether other coupons can be combined. Also confirm that tax and shipping are not being mistaken for the discountable subtotal.
What causes WooCommerce product variations to disappear?
Check that each intended combination exists, has a price and meets the store's stock rules. The variation guide separates product settings from a broken selector. Test a theme or plugin conflict on staging only after the product data is confirmed.
How do I run a WooCommerce plugin conflict test?
Contain customer email, payments and scheduled jobs on a staging copy before testing. Follow the conflict guide, retaining WooCommerce and the extensions needed to reproduce the fault. Change one component at a time and repeat the same basket and action.
When should a WooCommerce problem go to a developer?
Get help when payments, order data, customer information or live revenue are at risk, or when safe testing requires code or server access. Preserve order notes and logs and avoid repeated payment attempts while the transaction state is unclear.
Still dealing with a WooCommerce fault?
Tell us which part of the buying journey is failing and what changed. You will see the repair price before work begins.
Explore support options