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 when it spins, blanks, or fails on Place Order. Debug JS errors, sessions, SSL, and plugin conflicts step by step.
Cart
How to fix WooCommerce cart not updating
Fix WooCommerce cart when quantities won't change, items vanish, or totals stay at zero. Cover sessions, AJAX, cache, and mini-cart conflicts.
Payments
How to fix WooCommerce payment gateway errors
Fix WooCommerce payment gateway errors: API keys, webhooks, SSL, test vs live mode, and plugin conflicts when customers see generic payment failure messages.
Emails
How to fix WooCommerce order emails not sending
Fix WooCommerce order emails when customers and admins receive nothing. Debug wp_mail, SMTP plugins, spam filters, and WooCommerce email settings.
Shipping
How to fix WooCommerce shipping not calculating
Fix WooCommerce shipping when rates show zero or never apply at checkout. Zones, classes, address fields, and carrier API credentials.
Coupons
How to fix WooCommerce coupon not working
Fix WooCommerce coupons when codes show invalid, discounts do not apply, or free shipping coupons fail. Usage limits, exclusions, and stackable rules covered.
Products
How to fix WooCommerce product variations
Fix WooCommerce product variations when options grey out, prices don't update, or stock is wrong. Attributes, rows, and imports explained.
Stripe
How to fix WooCommerce Stripe payment failed
Fix WooCommerce Stripe when cards decline, Payment Element does not load, or orders stay pending. Keys, webhooks, SCA, and express checkout conflicts.
PayPal
How to fix WooCommerce PayPal not working
Fix WooCommerce PayPal when customers cannot pay, IPN fails, or PayPal buttons redirect to errors. Smart buttons, currency, and account holds explained.
Subscriptions
How to fix WooCommerce Subscriptions renewal failed
Fix WooCommerce Subscriptions when renewals fail or access drops after a card expires. Action Scheduler, gateways, and dunning explained.
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 a staging site and the gateway's test mode for repeatable checks. If a live test is necessary, use a controlled low-value order, confirm whether a charge or authorisation exists before retrying, and reconcile the test order afterwards.
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 gateway may have charged or authorised the payment without successfully notifying WooCommerce. Check the transaction, webhook or callback delivery, order notes and logs before asking the customer to pay again or manually changing the order status.
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?
Missing attribute terms, invalid default selections, stock settings, theme templates or JavaScript conflicts can prevent variations from appearing. Confirm the product data first, then test the default theme and minimal plugin set on staging.
How do I run a WooCommerce plugin conflict test?
Clone the issue to staging, switch to a default compatible theme and leave only WooCommerce plus the required gateway or extension active. Re-enable other extensions one at a time while repeating the exact failing 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.
Request a Fix