1.2 Installation & Updating - Installing and Uninstalling WooCommerce

Created by Danny Wong, Modified on Fri, 7 Aug, 2020 at 12:22 AM by Danny Wong

The core WooCommerce plugin can be installed and uninstalled the same as other WordPress plugins. Full installation and configuration of WooCommerce on your site is an additional optional step to help with full setup, this is available in the Setup wizard.

Take a moment to review the server requirements before installation or you may encounter issues when using WooCommerce. If you need a new host or don’t have one yet see our recommended hosts who can get you set up with WooCommerce right away.

With WooCommerce activated several items are added to your site for it to function properly:

  • New menu items, custom post types, and taxonomies for orders, products, and more.
  • New widgets and shortcodes.
  • User roles for shop managers and customers.

Deactivating and deleting the installed plugin does not remove any data in your site database so this requires an additional destructive step.

Installation via WordPress Admin

If you have an existing site and want to install WooCommerce, using the WordPress Admin is the most straightforward option as it handles everything for you.

Installation

To install WooCommerce:

  1. Go to: Plugins > Add New.
  2. Search for “WooCommerce”.
  3. Click Install Now.
  4. Click Activate Now and you’re ready for the WooCommerce Wizard.
Searching and showing the WooCommerce plugin via the Add Plugin WordPress screen.

WooCommerce Setup Wizard

When WooCommerce is activated for the first time, the WooCommerce Setup Wizard will be the next screen you see after clicking “Activate”.
This helps you set up and configure your site with WooCommerce functionality.

For a full walkthrough of the Setup Wizard (also known as the Onboarding Wizard), please read through the WooCommerce Setup Wizard documentation.

Multisite Network Installation

On a multisite network installation, WooCommerce acts like most other plugins. Each site in the network, although sharing a database, stores its information in separate tables. Each store is a separate setup.

While you can network-activate plugins, such as WooCommerce and its extensions, you would be unable to share product databases, checkout, and user accounts across sites in the network.

Only themes and plugins are shared across the network of sites.

Reverting to a Previous Version of WooCommerce

We always recommend using the latest version of all plugins and extensions on your site for security reasons. Further, the latest version of our plugins and extensions will always have the advantage of any features and functionality now available. As a consequence, this section is for guidance only.

To use a previous version of WooCommerce:

  1. Disable and delete the current plugin.
  2. Restore a previous backup of your store’s database.
  3. Download a previous version of WooCommerce under the Advanced View.
  4. Upload the previous version under Plugins > Add New.
  5. Activate the previous version of WooCommerce.

One warning — as mentioned in step two, you need to check and see if the version of the WooCommerce database has been updated or not. More often than not, it is updated with each version of WooCommerce, so you would need to restore your database from the previous version of WooCommerce to make sure everything works as it should.

This is why we highly recommend having backups in place alongside a staging environment to test new releases of mission-critical software like WooCommerce. See Updating WooCommerce for more information.

Uninstalling WooCommerce

There are two things to understand when uninstalling or removing WooCommerce.

  • If you deactivate and delete the plugin from WordPress, you only remove the plugin and its files. Your settings, orders, products, pages, etc… will still exist in the database.
  • If you need to remove ALL WooCommerce data, including products, order data, etc., you need to be able to modify the site’s wp-config.php file before deactivating and deleting the plugin.

To fully remove all WooCommerce data from your WordPress site, open your site’s wp-config.php file. Scroll towards the bottom, add define( 'WC_REMOVE_ALL_DATA', true ); on its own line above the /* That's all, stop editing! Happy publishing. */ line, this will be around line 76 of the file. Save the file to the server.
Then when you deactivate and delete WooCommerce it will remove all of its data from your WordPress site database.

define( 'WC_REMOVE_ALL_DATA', true ); added to the wp-config.php file

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article