Have you ever designed an e-commerce website on your local machine (local server) using XAMPP? Have you ever tried to update WooCommerce on the local server and you ran into an error? How about doing the same update on a live website and it failed?
If you answer yes to any of the above questions, then you are in the right place. In this article, I will walk you through step by step guide on how to fix the WooCommerce update error, both on a local server and on a live server.
This error is scary to beginners. This is because the WooCommerce plugin with all the products you have created will, sort of disappear from your dashboard. Also in the frontend, if you check the product page you won’t find any products.
Does it mean all the products you have created have been deleted automatically due to failed WooCommerce update? No! Not at all. All your products are still available in your database and you can retrieve them by just installing a fresh version of WooCommerce, but you need to delete the old installation folder before you install a new one. But the question is, “How do you get access to the old installation folder?” In this guide, I will answer this question.
As a matter of fact, this error is very simple to fix. And in this article, I will walk you through a step-by-step guide on how to fix it. So let’s get cracking!
How to Fix the Error on a Local Server
Since your WordPress site is hosted on your local machine using XAMPP, all your files should be located in the directory where you installed the XAMPP software. By default the installation is always on your C: drive. The following steps are for a XAMPP installation on a Windows 7 device. To locate the XAMPP folder in your C: drive, follow the steps below.
Step 1. Click the Windows Start Button and select “Computer” from the options, as shown in the image below.
Step2. Once you click on Computer as illustrated in the image above, you should be taken to another step that looks like the image below.
Step 3. Double click the Local Disk (C:) to open it up. You should be taken to another step that looks like the image below.
Step 4. The XAMPP folder is right there as can be seen on the image above. Double click it to open it in order to get access to all its contents. Once you open it you should see a folder that looks like the image below.
Step 5. As you can see from the image above, there are several folders within the XAMPP folder. Your WordPress installation is located in the folder named apps, as shown in the image above. Double click it to open it and you should see the WordPress folder right there. Again double click the WordPress folder to see another set of folders as shown in the image below.
As you can see in the image above, there are several other folders within the WordPress folder. Since we want to fix a plugin (WooCommerce) that failed to update, to get access to it, we will need to open the folder named htdocs as shown in the image above.
Step 6. Once we open the htdocs folder, we will again see other sets of folders as shown in the image below.
As we can see in the image above, there are three folders. WordPress themes and plugins are usually located in the folder named wp-content, so double click to open it – that should give you another interface that looks like the image below.
Looking at the image above, we see one of the folders is named plugin. Since WooCommerce is a plugin, we will open the folder in order to get access to WooCommerce. Once you open it you should see all the plugins you have installed on your WordPress website, as shown in the image below.
The image above shows all the installed plugins, one of which is WooCommerce, as indicated. What we need to do to fix the error, is to delete the folder. Don’t worry, deleting the folder does not affect the products you already created. All the product data are stored in your database, not in WooCommerce. So, click the folder, and delete it.
Once you delete it, go back to your WordPress dashboard and install a new version of WooCommerce. Activate it and you should see all your products, and that fixes the error.
How to Fix the Error on Live Server
For a website that’s already on a live server, you can fix this error by, also deleting the WooCommerce folder. But how do you locate the folder? In this guide, I will walk you through a step-by-step guide on how to do that.
Step 1. Login to your cPanel and locate the File Manage folder as shown in the image below.
Click the File Manager link as shown in the image above and that should take you to another page, as shown in the image below.
Looking at the image above, there are two panes. We are interested in the left pane. One of the folders there is named public_html. Click to expand it, as shown in the image below.
In my case, I have several websites hosted on this account that’s why there are so many folders, as seen in the image above. If you have only one website hosted on your account, you won’t see many folders like this.
On the other hand, if you have several websites hosted on your account (as in my own case), you would first of all open up the folder of the website you want to make changes to. Like in my own case, there are several folders on the left panel (as shown in the image above). Let’s say I want to make changes to a website hosted on the folder name dev, I will first of all open it to get access to the folder named wp-content. Look at the image below for a better understanding.
As stated earlier, the website I’m interested in is hosted on the folder named dev. Once I clicked to expand, there are sub-folders, as shown in the image above. To get access to plugins, I will need to again click on the sub-folder named wp-content. Once I do that I should see another set of folders as shown in the image below.
As we can see in the image above, one of the folders is named plugins. Since WooCommerce is a plugin, I will open this folder to get access to WooCommerce. Once I do that I should see another set of folders that looks like the image below.
As illustrated in the image above, delete the folder named woocommerce. After that, go back to your WordPress dashboard and install a new WooCommerce plugin. Activate it and that should fix the error.