Troubleshooting
WooCommerce Cart Page Not Working: Causes and How to Fix It

Short answer
A WooCommerce cart page usually stops working because the cart page is not assigned under WooCommerce settings, the page is missing the Cart block or shortcode, the page is cached, or a plugin, theme or script conflict breaks it. Check page setup first, then caching, then test for conflicts.
Key takeaways
- Check the Cart page under WooCommerce, Settings, Advanced first.
- The page needs the Cart block or the cart shortcode.
- Never cache the cart, checkout or my account pages.
- Use troubleshooting mode to find plugin and theme conflicts.
- Console and debug log errors usually name the cause.
- Re-save permalinks if the cart link returns a 404.
Why is the WooCommerce cart page not working?
The cart page usually breaks because the page is not assigned in WooCommerce settings, is missing the Cart block or shortcode, is being cached, or is affected by a plugin, theme or JavaScript conflict.
Not working can mean several things. The page may be blank, show a 404 error, say the cart is empty when it is not, load without styling, or refuse to update quantities.
Each symptom points to a different cause. Work through the checks below in order, since the first few fix most cases in a few minutes.
If the problem is that products vanish right after you add them, our guide to the cart being empty after adding a product goes deeper on session and cookie issues.
What should you check first?
First confirm a page is set as the cart page in WooCommerce settings, then open that page in the editor and make sure it contains the Cart block or the cart shortcode.
These two checks solve a large share of blank or missing cart pages. They often break after a theme change, an import or someone deleting the page by accident.
Before changing anything on a live store, take a backup. If you can, test on a staging copy first, as covered in our guide on setting up a staging site.
How do you check the cart page assignment?
Go to WooCommerce, then Settings, then the Advanced tab, and check that the Cart page field points to the right published page.
The Page setup section lists the cart, checkout, my account and terms pages. If the cart field is empty or points to a deleted page, WooCommerce cannot send shoppers there.
Pick the correct page from the dropdown and save. If the page no longer exists, create a new page called Cart, add the Cart block, publish it and select it here.
WooCommerce's own documentation on WooCommerce pages lists the default pages and how to recreate them.
How do you check the cart page content?
Open the cart page in the editor and make sure it contains the Cart block or the [woocommerce_cart] shortcode, and nothing that conflicts with it.
Newer stores use the Cart block by default. Older stores and some themes use the shortcode instead, often inside a Shortcode block.
A page with neither shows only its title or a blank area. A page with both can show two carts or odd errors.
Page builders can also wrap the shortcode in a way that breaks it. Try the plain block editor version of the page to rule this out.
| Symptom | Likely cause | First fix |
|---|---|---|
| Blank cart page | Missing block or shortcode | Add the Cart block |
| 404 on the cart link | Page deleted or not assigned | Reassign under Settings, Advanced |
| Cart shows empty | Caching or session cookie problem | Exclude cart from cache |
| Quantities will not update | JavaScript or Store API blocked | Check console and security plugins |
| Page loads without styling | Theme or optimization plugin conflict | Disable CSS and JS optimization |
| Critical error message | PHP error in a plugin or template | Check the debug log |
Our comparison of Cart and Checkout blocks vs shortcodes explains the differences between the two setups.
Could caching be breaking the cart?
Yes, cached cart pages are one of the most common causes, because the cache serves the same stored page to every visitor instead of their own cart.
The cart, checkout and my account pages must never be cached. Most caching plugins exclude them automatically when WooCommerce is active, but custom rules, server caching or a CDN can override that.
Check your caching plugin's exclusion list. Then check any host-level cache and any CDN page rules, since these run outside WordPress.
After changing settings, clear every cache layer. Our guide on how to clear cache in WordPress covers plugins, hosts and CDNs.
Could a plugin or theme conflict be the cause?
Yes, a plugin or theme can break the cart page by loading broken scripts, overriding templates or blocking WooCommerce requests, so test with everything else switched off.
The safest way is the Health Check & Troubleshooting plugin. Its troubleshooting mode turns off plugins and switches to a default theme only for your own session, so shoppers are not affected.
Turn on WooCommerce alone and check the cart. If it works, turn other plugins back on one at a time until it breaks again.
Optimization plugins that combine, delay or defer JavaScript are frequent suspects. Add the cart and checkout pages to their exclusion list.
WooCommerce's guide to pages not displaying walks through the same conflict test.
How do you check for JavaScript errors?
Open the cart page, open your browser's developer tools, look at the Console tab, and note any red errors while you change a quantity or remove an item.
The Cart block relies on JavaScript to load and update the cart. A single error from another script can stop it from working.
The Chrome DevTools Console guide explains how to read these messages. Errors usually mention the plugin or theme file that caused them.
Also check the Network tab. Failed requests to addresses containing wc/store point to blocked Store API calls, which the Cart block uses to update the cart.
Could a security plugin or firewall block the cart?
Yes, some security plugins, firewalls and REST API restrictions block the requests the Cart block needs, which leaves the cart stuck loading or unable to update.
The Cart block talks to WooCommerce through the WordPress REST API. If a plugin disables the REST API for visitors who are not logged in, the cart can fail for shoppers while working for you as an admin.
Test in a private browser window while logged out. If the cart breaks only there, review REST API and firewall settings in your security tools.
How do you find PHP errors behind a broken cart?
Turn on WordPress debug logging, reload the cart page, then read the debug log file for fatal errors or warnings that mention a plugin, theme or WooCommerce template.
The WordPress debugging documentation shows how to enable WP_DEBUG and WP_DEBUG_LOG in your config file.
WooCommerce also has its own logs under WooCommerce, then Status, then Logs. Fatal errors are often recorded there too.
Turn debugging off again when you are done, so error details are not shown to visitors.
Could outdated template files cause the problem?
Yes, themes that override WooCommerce cart templates can break after WooCommerce updates if their copies are out of date.
Go to WooCommerce, then Status, and scroll to the Templates section. It lists overridden files and flags any that are outdated.
If the cart template is flagged, update the theme or ask its developer for a fix. Our explainer on the WooCommerce status report shows how to read this section.
This mainly affects the shortcode cart. The Cart block does not use the classic PHP cart template in the same way.
What else can stop the cart page from working?
Broken permalinks, mixed HTTP and HTTPS settings, expired sessions and a wrong site address can also break the cart, so check these if the steps above did not help.
Go to Settings, then Permalinks, and click Save without changing anything. This rebuilds rewrite rules and often fixes a cart link that returns 404.
Make sure the WordPress Address and Site Address under Settings, General both use HTTPS if your site has SSL. Mixed addresses can drop session cookies.
If shoppers see session errors, read our guide to the WooCommerce session expired error.
If the problem moves on to checkout, see WooCommerce checkout not working.
How do you stop the cart from breaking again?
Keep WooCommerce, your theme and plugins updated, test updates on staging, exclude cart pages from caching and optimization, and check the cart after every major change.
Add a quick cart test to your update routine. Add a product, change the quantity, apply a coupon and move to checkout.
Keep a note of which plugins touch the cart, such as upsell tools, currency switchers and shipping calculators. These are the first ones to check if problems return.
Frequently asked questions
Why is my WooCommerce cart page blank?
A blank cart page usually means the page is missing the Cart block or cart shortcode, or a PHP or JavaScript error stops it from rendering. Open the page in the editor to check its content, then look at the browser console and debug log for errors.
How do I reset the WooCommerce cart page?
Create a new page, add the Cart block, and publish it. Then go to WooCommerce, Settings, Advanced and choose the new page in the Cart page field. Save the settings, clear your caches and test by adding a product to the cart.
Why does my cart show empty after adding products?
The cart page is probably cached, or the session cookie is not being kept. Exclude cart, checkout and account pages from all caching, check that your site address uses HTTPS consistently, and test in a private window to rule out browser issues.
Why will the WooCommerce cart not update quantities?
Updating quantities needs JavaScript and, for the Cart block, the WooCommerce Store API. A script error from another plugin, an optimization plugin delaying scripts, or a security tool blocking REST API requests can all stop updates. Check the browser console first.
Should I use the Cart block or the cart shortcode?
New stores generally use the Cart block, which is the current WooCommerce default. The shortcode still works and may suit stores that rely on older extensions not yet compatible with blocks. Use one or the other on the page, not both.
Sources
- WooCommerce pages not displaying WooCommerce
- WooCommerce Pages WooCommerce
- Debugging in WordPress WordPress Developer Resources
- Health Check & Troubleshooting WordPress.org
- Console overview Chrome for Developers
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


