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

  • Troubleshooting using Health Check

    The Health Check & Troubleshooting plugin is useful for troubleshooting problems on your WooCommerce site, particularly those related to plugin and/or theme conflicts. It allows you to do several tests in a browser session, without affecting visitors to your live site. However, keep in mind that, given a particular combination of plugins, themes, and hosting […]

  • 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 dashboard

    You can access help from most WooCommerce pages in your store’s WP Admin dashboard via the Help tab. How to find the Help tab Help options A detailed help screen will appear with three tabs on the left side: More information The right-hand sidebar contains more options:

  • 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 extensions/plugins

    Free WooCommerce extensions or plugins do not require an active subscription to get updates. You may see subscriptions for free extensions or plugins listed 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 via WP […]

  • WooCommerce pages not displaying

    If you are having trouble with WooCommerce pages not installing or displaying content correctly, here’s how you can fix this: Note: This document does not cover every imaginable case. We recommend reviewing our troubleshooting guide to determine whether there is a conflict on your site. WooCommerce pages updated to endpoints Before WooCommerce 2.1, 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 Jetpack’s site accelerator or Cloudflare to speed your site up […]

  • HTTP 500 Internal Server Error — getting more information

    An HTTP 500 Internal Server Error is a commonly encountered error. It is often temporary and is a general server error response. Error message Generally, an HTTP 500 Internal Server Error’s output is not descriptive and does not help narrow down the cause of the issue. It is considered best practice to show a generic error […]

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.