Take a moment to review server requirements before installation, or you may encounter issues when using WooCommerce.
Upon activation, WooCommerce installs several items it requires to function properly:
- New pages for handling the shop, cart and checkout pages
- Custom post types and taxonomies for orders and products
- New widgets and shortcodes
- User roles for shop managers and customers
Install WooCommerce ↑ Back to top
Automatic Installation ↑ Back to top
If you have web hosting and would like to install WooCommerce, using the WordPress Admin is the most straightforward option, as it handles the file transfer without you needing to leave the Web browser.
To install WooCommerce:
- Log into your WordPress Admin panel.
- Go to: Plugins > Add New.
- Type ‘WooCommerce’ into the Search Plugins field and hit Enter. Once found, you can view details on the point release, rating and description.
- Click Install Now. After clicking the link, you’ll be asked to confirm this action.
- Click Yes, and WordPress completes the installation.
You need to be running WordPress on a self-hosted site. We have partnered with Bluehost to offer you a custom packaged solution that pre-installs WordPress, WooCommerce, our Storefront theme and eCommerce specific features like a dedicated IP and SSL certificate to keep your store protected and secure. Learn more at BlueHost and Woo.
With some hosting companies, you may be taken to a page requesting FTP details of your webserver, if you’ve not previously installed a plugin on this WordPress installation. Fill in your details to complete installation. Those details can be received from your hosting company.
Once WooCommerce is activated, the WooCommerce Onboarding Wizard can help you set up your shop.
Select Let’s Go! to get started. Or select Not Right Now if you prefer to manually set up your WooCommerce shop.
Manual Shop Setup
You can add the WooCommerce pages in several ways:
- Go to: WooCommerce > Help > Setup Wizard > Setup Wizard. Add the pages in the second step.
- Go to: WooCommerce > System Status > Tools > Install Pages.
- Create the pages yourself, and add them in WooCommerce > Settings >
- Products > Display > Shop Page
- Checkout > Checkout Options > Cart Page and Checkout Page
- Accounts > My Account Page
Theme not displaying correctly? ↑ Back to top
If you are using a third-party (non-Woo) theme and WooCommerce pages aren’t displaying correctly, ensure that your theme declares WooCommerce support. Look at the theme details page or contact the theme developer to ask.
If you have a theme you want to use with WooCommerce that does not yet have WooCommerce support, see: Third-Party Custom Theme Compatibility.
No zip file to upload to WordPress ↑ Back to top
The settings on your Mac have automatically unzipped the theme file you downloaded.
- Re-download using another browser that doesn’t auto-unzip, or
- Right click the folder on your Mac, and select “Compress…” which creates a new zip file.
Then upload the zip file via Appearance > Themes > Upload.
Uninstall WooCommerce ↑ Back to top
There are two things to understand when uninstalling WooCommerce.
- If you deactivate and delete the plugin from the WordPress Admin, you are deleting WooCommerce settings and database tables, and trashing the pages created when first installed.
- If you need to remove ALL WooCommerce data, including products, order data, etc., go to: WooCommerce > System Status > Tools, and enable the Remove post types on uninstall. Doing this deletes all WooCommerce data when you deactivate and delete the plugin from the WordPress Admin.
Installation on a multisite ↑ Back to top
On a multisite install, WooCommerce acts as any other plugin. Each site in the network, although sharing a database, stores its information in separate tables. Thus, each site/store is a separate silo setup.
While you can network-activate plugins,such as WooCommerce and its extensions, you would not be able to share product databases, checkout, user accounts, etc. across sites in the network.
Only themes and plugins are shared across the network of sites.
Revert to a previous version ↑ Back to top
To roll back WooCommerce to a previous version:
- Disable the plugin.
- Download and unzip the older version of the plugin from the WooCommerce repository on GitHub.
- Log into your server with FTP.
- Remove the newer version.
- Upload the older plugin directory to wp-content/plugins/.
We always recommend using the latest version of all plugins and extensions on your site for security reasons and to take advantage of any features and functionality currently available. We offer this section as guidance only.