Documentation

Learn how to set up, customize, and expand the functionality of WooCommerce

Troubleshooting

Not sure where to start? Check out our Troubleshooting Guide to read about common issues and their solutions.


Documents

  • Backing up WordPress content

    Each store powered by WooCommerce and WordPress has two places where its data and content are stored: So, how should you safeguard your content and keep it backed up? Automatic backups The most efficient and reliable approach is to use an automated backup service; we recommend Jetpack VaultPress Backup. By using Jetpack Vaultpress Backup, you’ll benefit from: Manual […]

  • Get Help in Your WooCommerce Store Admin

    You can quickly find Help right where you are struggling when getting started with WooCommerce. All from within the WordPress admin of your store. How to Use “Help” Help can be accessed from every page in the WordPress Dashboard that is related to WooCommerce and Products. Depending on which page you’re on, the tabs will vary and be relevant. […]

  • How to update WooCommerce

    Updates to WooCommerce, WordPress, extensions, themes, and payment gateways are a fact of life. Our team is hard at work, releasing updates that add new features, improve security, fix issues, and, in general, make your store better than ever. But how do you update WooCommerce without causing issues? We’ll cover a few of the common ways below. […]

  • Migrating products between sites

    Data portability is a fundamental advantage of platforms like WooCommerce and WordPress, WooCommerce empowers merchants to fully own and control their data. This ensures that you can freely transfer and utilize your data across different systems as needed. In the context of this documentation, we’ll cover some options for exporting and migrating WooCommerce products. How […]

  • Updating free WooCommerce plugins

    Our free WooCommerce extensions/plugins do not require an active subscription to get updates. You may see subscriptions for free extensions listed on the My Subscriptions page in your store’s WP Admin dashboard at WooCommerce > Extensions > My Subscriptions); however, they will not have a toggle to activate a subscription. To update these free extensions/plugins, […]

  • WooCommerce Pages not Displaying

    If you are having trouble with pages not installing properly or not displaying content, you can fix this: *Note that this doc doesn’t cover every imaginable case. We recommend using the Troubleshooting Guide to determine if there is a conflict on your site. 2.1 WooCommerce Pages Update Prior to WooCommerce 2.1, there were individual pages […]

  • Completed Order Email doesn’t Contain Download Links

    On some WooCommerce installs you can experience the following issue: when a customer purchases a downloadable product, the Complete Order Email doesn’t contain any download link for the customer to download purchased products. Here is how the email looks like in that case: While it should look like this: Missing SQL Table This happens because a […]

  • Troubleshooting a slow site

    The first step for troubleshooting a slow WooCommerce site is to determine the root cause. Cache and CDN Using a caching plugin such as WP Super Cache is a good way to optimize site performance. You can also use a Content Delivery Network (CDN) such as Cloudflare, or Jetpack’s site accelerator to speed your site up […]

  • Internal Server 500 Error – Getting more information

    Error message A common error in WordPress is an HTTP 500 error and will look something like the image below. 500 errors are general server errors and can often be temporary. Generally the output shown is not descriptive and will not help narrow down the cause of the issue. In production sites, it is best practice […]

  • Endless loading/spinner on the checkout page

    The ‘review order’ page loads the payment methods/totals via ajax – this display a loading spinner briefly. If there are problems, this section may fail to load or the spinner may remain. First you should check WooCommerce > System Status for errors – often errors will be highlighted. Still having problems? Common causes and resolutions […]

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.