WooCommerce pages not displaying

WooCommerce relies on specific pages to display the cart, checkout, and customer account. If these pages are missing, blank, or not displaying content correctly, there are several possible causes — from missing page assignments to permalink issues, caching problems, or plugin and theme conflicts. This guide helps you diagnose the issue and fix it.

Possible causes

↑ Back to top

When WooCommerce pages are not displaying correctly, the issue is usually one of the following:

Missing or unassigned pages — The required WooCommerce page does not exist or is not assigned in your WooCommerce settings.
Permalink issues — Outdated or broken permalink settings can prevent WooCommerce pages and endpoints from loading.
Caching — A caching plugin or server-level cache is serving an outdated version of the page.
Plugin or theme conflict — Another plugin or your active theme is interfering with WooCommerce page output.

The sections below provide step-by-step fixes for each of these causes.

Flush permalinks

↑ Back to top

Outdated permalink settings are one of the most common reasons WooCommerce pages return a 404 error or display blank content. Flushing permalinks forces WordPress to rebuild its URL routing rules.

Go to Settings > Permalinks in your WordPress admin.
Without changing any settings, click Save Changes.
Visit the affected WooCommerce page on the front end of your site to check whether the issue is resolved.

Clear your cache

↑ Back to top

If you use a caching plugin (such as WP Super Cache, W3 Total Cache, or LiteSpeed Cache) or your hosting provider applies server-level caching, a cached version of the page may be served instead of the current content.

Clear the cache in your caching plugin. The exact steps depend on which plugin you use — check the plugin’s documentation if you are unsure.
If your hosting provider offers server-level caching, clear that cache as well. You can usually do this from your hosting control panel.
Clear your browser cache, or open the page in an incognito or private browsing window.
Visit the affected WooCommerce page to check whether the issue is resolved.

Note: WooCommerce cart and checkout pages should typically be excluded from caching because they contain dynamic, session-specific content. Check your caching plugin settings to confirm these pages are excluded.

Recreate pages using WooCommerce blocks

↑ Back to top

WooCommerce now provides dedicated blocks for core store pages. Blocks are the recommended approach because they integrate with the WordPress block editor, offer more customization options, and receive ongoing updates. If a WooCommerce page is missing or its content has been deleted, you can recreate it using the appropriate block.

Go to Pages > Add New in your WordPress admin.
Give the page an appropriate title (for example, “Cart,” “Checkout,” or “My Account”).
Click the + block inserter and search for the relevant WooCommerce block:
- Cart block — for the cart page.
- Checkout block — for the checkout page.
- My Account block — for the customer account page.
Insert the block into the page.
Click Publish.
Navigate to WooCommerce > Settings > Advanced and select the Page setup section.
Assign your newly created page to the appropriate option (for example, set the Cart page dropdown to your new Cart page).
Click Save changes.

(descriptive link text describing the destination) about WooCommerce blocks.

Recreate pages using shortcodes

↑ Back to top

If you prefer to use legacy shortcodes instead of blocks, you can recreate WooCommerce pages by adding the correct shortcode to a new page inside a Shortcode block.

The following shortcodes are available for core WooCommerce pages:

[woocommerce_cart] — Displays the cart page.
[woocommerce_checkout] — Displays the checkout page.
[woocommerce_my_account] — Displays the customer account page.
[woocommerce_order_tracking] — Displays the order tracking form.

After creating the page, assign it in WooCommerce > Settings > Advanced > Page setup and click Save changes.

See the full list of shortcodes included with WooCommerce.

Note: Older versions of WooCommerce (before 2.1) used additional shortcodes for pages such as Edit Account, Change Password, and View Order. These pages are now handled as endpoints appended to the main account and checkout pages. If you are running a current version of WooCommerce, you do not need these legacy shortcodes. (descriptive link text describing the destination) about WooCommerce endpoints.

Check for plugin and theme conflicts

↑ Back to top

If the steps above do not resolve the issue, a plugin or theme conflict may be preventing WooCommerce pages from displaying correctly. To test for conflicts:

Temporarily switch to a default WordPress theme (such as Twenty Twenty-Four) and check whether the page displays correctly. If it does, your theme is likely the cause.
If switching themes does not help, deactivate all plugins except WooCommerce. Check the page again.
If the page works with other plugins deactivated, reactivate plugins one at a time to identify which one causes the conflict.

For detailed instructions, review the WooCommerce self-service troubleshooting guide.

WooCommerce endpoints

↑ Back to top

Since WooCommerce 2.1, individual pages for account management and order confirmation have been replaced by endpoints. Endpoints are appended to the main account and checkout page URLs (for example, /my-account/edit-account/) instead of requiring separate pages.

If an endpoint URL returns a 404 error, try flushing your permalinks first. You can also review and customize endpoint slugs at WooCommerce > Settings > Advanced > Endpoints.

(descriptive link text describing the destination) about WooCommerce endpoints.

↑ Back to top

Questions and support

↑ Back to top

Do you still have questions and need assistance?

This documentation is about the free, core WooCommerce plugin, for which support is provided in our community forums on WordPress.org. By searching this forum, you’ll often find that your question has been asked and answered before.

If you haven’t created a WordPress.org account to use the forums, here’s how.

If you’re looking to extend the core functionality shown here, we recommend reviewing available extensions in the WooCommerce Marketplace.
Need ongoing advanced support or a customization built for WooCommerce? Hire a Woo Agency Partner.
Are you a developer building your own WooCommerce integration or extension? Check our Developer Resources.

If you weren’t able to find the information you need, please use the feedback thumbs below to let us know.