Update instructions #

To ensure that the update process runs as smoothly as possible:

1. Make a full backup of your site, data, and files.
   • Ask your hosting company to assist you, or
   • Use Jetpack Backup (it’s free)
2. Go to Dashboard > Plugins, and update third-party plugin(s) that are out of date. Do not update WooCommerce yet.
3. Update extensions purchased from WooCommerce.com. You can also download the extension(s) from your WooCommerce.com account and overwrite plugin(s) manually via File Transfer Protocol (FTP) in /wp-content/plugins/
4. Go to: WordPress Dashboard > Plugins and update WooCommerce to its latest stable version.
5. Update WordPress to its current version. A notification in your WordPress dashboard tells you whether an update is available or not.
6. Update your theme to the current version. Check with the author to see if you’re running the latest version.

Learn how to update WooCommerce.

Plugin and theme conflicts #

Almost half of the interactions we receive are related to issues caused by conflicts with third-party themes and plugins. Troubleshooting and conflict testing are the best ways to identify the conflict.

Performing a conflict test can be a time-consuming, technical challenge. If you’d like someone else to do this work for you, our trusted partner Codeable has an offering where they will run this test for a flat fee. If there is time left, they will also fix the problems they found.

To troubleshoot theme and plugin conflicts:

1. Switch to a default WordPress theme to see if the problem still exists. If it disappears, contact your theme developer about the issue; there may be an update available that solves it. If the problem persists while using a default theme, go to the next step.
2. Temporarily deactivate all plugins (except WooCommerce and the WooCommerce.com extension(s) giving trouble). Does that fix it?
   • If yes, it’s likely there is a conflict with one of the disabled plugins. To pinpoint which one, reactivate plugins one at a time, repeat the actions taken when the issue appeared, and see when/if the issue reappears.
   • If not, and the issue remains while running a default theme with no extra plugins activated, go to the next step.
     Please note we cannot provide support for third-party plugins and themes. If a conflict test reveals the issue is a conflict between WooCommerce software and a third-party plugin or theme, please contact the developer of the plugin or theme in question.
3. Contact one of our Happiness Engineers to investigate and advise. In your support request, please provide us with as much info as possible. Answering the following questions will help speed up the process:
   • When exactly did you first notice the problem?
   • Have any updates been applied to your website recently?
   • Have you changed themes or made design changes?
   • Have you installed any new plugins?
   • Can the issue be replicated on multiple devices?
   • Is your problem happening in one browser or all of them?
   • Do you see a specific error message? Please take and share a screenshot.

See how to test for theme and plugin conflicts.

Troubleshooting #

Fatal errors #

Fatal error messages typically tell you the path, including the name of the plugin or theme causing it. This helps track down where/what to fix.

System status #

The WooCommerce System Status Report provides a wealth of info on versions, template overrides, and memory. To access it, go to WooCommerce > Status > System Status.

Items requiring action will be highlighted in red. This may include updating memory, creating pages correctly, or updating outdated plugins. Learn how to understand the System Status Report.

Slow sites #

See our guide for troubleshooting a slow site for tips and tricks.

FAQs #

How do I manually upload a plugin? #

A zip file can be uploaded directly via your WordPress admin, under Plugins > Add New. If uploading a newer version of the plugin, updates will be applied automatically

Alternatively, to update a plugin manually via FTP, unzip the download, upload the files via FTP, and overwrite existing files. There is no need to deactivate the plugin or delete files. You cannot automatically update WooCommerce plugins via your WordPress admin unless you activate your subscription — you must do it via FTP.

Where do I find my downloads and keys? #

Extensions and theme subscriptions purchased from the official WooCommerce.com Marketplace do not use manually entered keys. To activate a subscription for these products, please connect your WooCommerce.com account to your store.

You can also:

• Visit My Downloads to manually download purchased extensions and themes.
• View My Subscriptions to manage extension and theme renewals.

Can you help with customizations? #

Requesting a new feature or help with customization is beyond the scope of our Support Policy. Customizations or particular features/functionality can be addressed by contacting Codeable.

Ideas or feature requests for official WooCommerce.com Marketplace extensions and WooCommerce core can be posted directly on our Feature Request Board. We act on feedback and ideas with the highest priority.

Why am I getting the message, “WooCommerce Data Update Required”? #

You’re running an older version of the WooCommerce database compared to the plugin version you have active and need to update to the latest. More info at: How to Update WooCommerce – Data update notice.

Why are my data sets not saving? #

If you notice product variations, tax rates, and other large data sets not saving, see solutions at Problems with large amounts of data not saving (variations, rates, etc).

I found a bug; what do I do? #

If you have found a bug in the core WooCommerce plugin (not in an extension or theme) that persists after performing the above troubleshooting steps, report it to our developers at the WooCommerce GitHub repository.

Documentation #

Our documentation covers all of our plugins, extensions, and themes in detail. We put a lot of effort into improving content and making it easier to navigate.

Here are a few resources to assist you:

• WooCommerce troubleshooting
• How to work with variable products
• Translation/localization
• Fixing blurry product images
• Fixing outdated WooCommerce templates

Questions and support #

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.