To install WooCommerce manually, download the official WooCommerce .zip, upload it from WP Admin > Plugins > Add New Plugin > Upload Plugin, choose Install Now, and then Activate. If WordPress will not accept dashboard uploads, extract the ZIP and upload the woocommerce directory to wp-content/plugins with FTP or SFTP, then activate it from the Plugins screen.
Antihost offers managed WordPress hosting with free migration, one-click staging and a 14-day free trial.
This guide covers both real manual installation paths, the access and compatibility checks each requires, correct directory placement, first activation, extension ZIPs, and recovery steps when the installer is unavailable or rejects the archive.
As an Amazon Associate I earn from qualifying purchases.
Quick wins for a faster PC:
Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Repair Windows errors before they cause bigger problemsFix Now →Scan for outdated or missing drivers - takes under a minuteDriver Scan →What you need before installing WooCommerce
A manual installation changes your WordPress files and enables a store application, so prepare the site before uploading anything. You need one of the following access combinations:
- Dashboard route: a working WordPress site and an administrator account that can install and activate plugins.
- Server route: access to the web server through FTP or SFTP, plus enough permission to write to
wp-content/plugins. You will still normally need WP-Admin access to activate the copied files.
Download WooCommerce only from its official WooCommerce or WordPress.org distribution. For the dashboard method, keep the downloaded package as a single .zip file; do not unzip it first. If you are installing a paid WooCommerce Marketplace extension rather than core WooCommerce, download that extension’s ZIP from the account area where your subscriptions or downloads are listed. An extension archive and the core WooCommerce archive are separate products.
#1 Best Overall
Make a current backup of the database and site files. For a live store, test a version change on staging first. A backup gives you a recovery point if activation exposes a PHP incompatibility, a file-permission problem, or a conflict with another plugin. Record the version you are replacing or adding so you can identify the files and database state that need restoring if a rollback becomes necessary.
Have your hosting information available if you need the server route: the server address, account name, password or key, and the FTP/SFTP port supplied by the host. If a managed WordPress provider controls plugin installation, ask the administrator whether direct uploads are allowed before attempting either method.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Check WordPress, PHP, and database compatibility
Manual upload does not bypass WooCommerce’s system requirements. WooCommerce’s current requirements guidance recommends PHP 8.3 or newer and states that WooCommerce works with PHP 7.4 or newer. It recommends MySQL 8.0 or newer or MariaDB 10.6 or newer. The requirements page also contains a version matrix that maps each WooCommerce release to its minimum WordPress and PHP versions.
Examples in the 2026 requirements matrix are:
| WooCommerce release | Minimum WordPress version | Minimum PHP version | Qualification |
|---|---|---|---|
| 10.8 | 6.9 | 7.4 | Figures published in WooCommerce’s 2026 requirements table; verify the matrix before installing because requirements can change. |
| 10.0 | 6.7 | 7.4 | Figures published in WooCommerce’s 2026 requirements table; verify the matrix before installing because requirements can change. |
The minimum and recommended figures are different. A site running PHP 7.4 may meet the stated minimum for a release, while PHP 8.3 or later is the recommended environment. Meeting only the minimum can also leave less room for a theme or extension that has its own requirements. Compare the exact WooCommerce release you downloaded with the current matrix rather than relying on an old tutorial.
Check your versions in your hosting control panel or in WordPress’s Site Health and system-information screens. Confirm the WordPress version, PHP version, and whether the database is MySQL or MariaDB. If your host still runs an older PHP or database release, upgrade through the host before installation when the matrix requires it, and test that upgrade on staging when possible. Do not assume that a successful file upload proves the environment is compatible; compatibility is tested when WordPress loads and activates the plugin.
Understand the WooCommerce ZIP you are installing
Core WooCommerce is downloadable software, not a physical item. The file used in the dashboard route is a plugin ZIP. Keep that archive unchanged until WordPress has received it. A theme ZIP, a compressed backup, an extension ZIP, or an incomplete download cannot substitute for the core plugin package.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problemsIf the package comes from a WooCommerce Marketplace account, verify the product name before downloading. The account may contain several extension ZIPs. Install core WooCommerce first unless the extension’s own instructions state a different order. Installing an extension without its required core plugin will not create a complete WooCommerce store.
Method A: install the WooCommerce ZIP from WP Admin
This is the simplest manual route when you can sign in to the dashboard and the host permits plugin uploads. WordPress handles extraction and places the files in the normal plugins directory, so there is less opportunity for an incorrect folder level.
- Download the package. Obtain the official WooCommerce ZIP. Leave it compressed; the WordPress installer expects the
.zipupload. Save the original file locally until you have confirmed activation. - Open the plugin installer. Sign in to WordPress and go to Plugins > Add New Plugin.
- Choose the upload screen. Click Upload Plugin. If that control is absent, your user role, host configuration, or WordPress installation may restrict plugin installation; use the server method below or ask the site administrator.
- Select the ZIP. Click Choose File, select the downloaded WooCommerce
.zip, and confirm the selection. Do not select the extracted folder for this route. - Start installation. Click Install Now. WordPress uploads the archive, extracts it into the plugins directory, and registers the plugin.
- Read the result. Wait for WordPress to report whether installation completed. Do not close the page or start a second upload while the first operation is running.
- Activate WooCommerce. When WordPress reports that installation is complete, click Activate. You can also activate it later from Plugins > Installed Plugins.
- Complete initial configuration. On first activation, WooCommerce opens its Setup Wizard. Enter the basic store details and choose the initial settings the wizard requests. You can adjust store settings later in the WooCommerce administration screens.
Do not upload a folder or a ZIP intended for a theme. The file selected in the upload step must be the WooCommerce plugin package. A successful upload is not the same as an activated store: the plugin must be activated before the Setup Wizard appears and before WooCommerce’s features are available.
If the installer reports that the file already exists, check Plugins > Installed Plugins before trying again. You may already have WooCommerce installed but inactive. If a previous version is active, treat a replacement as a version change: back up the site and test it on staging rather than overwriting a live store casually.
Installing a Marketplace extension with the same route
A WooCommerce extension follows the same manual pattern when its documentation allows ZIP installation: download the extension’s own ZIP from the account’s downloads or subscriptions area, then use Plugins > Add New Plugin > Upload Plugin. Install and activate core WooCommerce first unless the extension’s instructions state otherwise. An extension ZIP is not a substitute for the core WooCommerce ZIP.
After activation, check the Installed Plugins list for both entries. The extension may add its own settings area, but the basic WooCommerce Setup Wizard belongs to core WooCommerce and normally appears on its first activation. Keep the extension ZIP and version information with your site records so future updates can be matched to the correct subscription or download.
Method B: install by FTP or SFTP when dashboard upload is blocked
Use this fallback when Upload Plugin is missing, the upload is rejected by a hosting limit, or the dashboard cannot write plugin files. WooCommerce’s developer guidance describes manually uploading the plugin directory to wp-content/plugins; WordPress.org documents the same general manual approach using an FTP application. SFTP is preferable when your host offers it because it encrypts the file transfer; use the connection details supplied by your host.
Rank #2
- Download and extract WooCommerce locally. Start with the official ZIP, then extract it on your computer. The extracted package should contain a plugin directory named
woocommerce. - Inspect the extracted folder. Make sure you are moving the actual
woocommercedirectory, not a containing folder that merely holds it. The final remote path must be one directory namedwoocommercedirectly belowplugins. - Connect to the server. Open your FTP or SFTP client and sign in with the server address, username, password or key, and port supplied by your host.
- Open the WordPress plugins directory. In the remote site, locate the WordPress installation and then open
wp-content/plugins. A host may have several WordPress installations, so confirm that this is the installation you intend to change. - Upload the directory. Transfer the extracted
woocommercedirectory itself intowp-content/plugins. The final path should bewp-content/plugins/woocommerce, with WooCommerce’s plugin files inside that directory. - Wait for transfer completion. Confirm that the client reports all files transferred. An interrupted transfer can leave a directory that exists but lacks the files WordPress needs to recognize or activate the plugin.
- Return to WordPress. Sign in to WP Admin and open Plugins > Installed Plugins.
- Activate the plugin. Find WooCommerce and click Activate. If it is not listed, stop and correct the directory layout before trying to activate anything.
- Run the Setup Wizard. Follow the first-activation wizard for the store’s basic configuration.
Do not copy an entire WooCommerce source repository into wp-content/plugins. In a source checkout, the actual plugin is inside the repository’s plugins/ directory; only the correctly placed plugin directory should be installed, or the source should be linked according to the developer documentation. A repository-level folder in the wrong location will not appear as an ordinary WooCommerce plugin.
Recommended Free Tools
Check the directory layout after an FTP/SFTP upload
The most useful path check is simple: open the remote wp-content/plugins directory and look for a single woocommerce folder there. The expected arrangement is:
wp-content/
plugins/
woocommerce/
...WooCommerce plugin files...A nested arrangement such as wp-content/plugins/woocommerce/woocommerce usually means the outer containing folder was uploaded instead of the plugin directory itself. WordPress scans the plugins directory for plugin files; it will not treat an incorrectly nested copy as the normal WooCommerce plugin. Move the inner directory up one level, then refresh the Installed Plugins screen.
Do not place the extracted directory beside plugins, inside a theme directory, or at the root of a source repository. The documented destination is the site’s own wp-content/plugins directory.
Which manual method should you choose?
| Consideration | WP Admin ZIP upload | FTP/SFTP directory upload |
|---|---|---|
| Access required | WordPress administrator access and a dashboard that permits uploads | FTP or SFTP server credentials with write access, plus WP Admin access for activation |
| Setup complexity | Lower: WordPress extracts and places the files | Higher: you must extract the ZIP and place the directory correctly |
| Works around dashboard upload limits | No; it uses the dashboard’s upload and server limits | Often yes, when direct file transfer is allowed by the host |
| Main placement risk | Usually low because WordPress handles extraction | The directory can be nested too deeply or uploaded beside, rather than inside, wp-content/plugins |
| Best use | Most administrators installing a normal official ZIP | A blocked, restricted, or unavailable dashboard upload |
Choose the dashboard method unless it is unavailable. It requires fewer credentials and lets WordPress perform the extraction. Choose FTP/SFTP when the archive exceeds a dashboard limit, the upload control is disabled, or your host specifically instructs you to transfer files. The server method is a fallback, not a requirement for a normal manual installation.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Verify the installation before configuring products
After activation, confirm that the plugin is actually usable rather than merely present on disk.
- WooCommerce appears as Active under Plugins > Installed Plugins.
- The WooCommerce administration menus and Setup Wizard are available to the administrator.
- The site loads without a PHP fatal-error screen after activation.
- Your WordPress, PHP, MySQL, or MariaDB versions meet the current WooCommerce matrix.
- The site remains reachable in a private browser window or another session after activation; this helps reveal a front-end problem that is not visible in the administrator screen.
- The store’s basic address, currency, tax approach, and other initial choices in the wizard match the intended operating region before you add products or accept orders.
Activation does not automatically complete payment, tax, shipping, email, or product configuration. Those are subsequent store-setup decisions. Finish the wizard, then review each operational area before opening the store to customers. The wizard is an initial configuration aid, not proof that checkout is ready for live orders.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Troubleshoot common installation failures
Upload Plugin is missing
First confirm that you are signed in with an administrator account and are looking under Plugins > Add New Plugin. A managed WordPress environment or a restricted user role may remove upload controls. If you have server credentials, use the FTP/SFTP method and activate the copied directory from Plugins > Installed Plugins. Otherwise, the person who controls the WordPress installation or hosting account must perform the upload.
The ZIP is rejected or installation stops
Download the official package again and make sure the selected file is a plugin ZIP, not a theme archive, an extension intended for a different product, or an incomplete download. Keep the original ZIP intact for the dashboard route. If repeated uploads fail because of a host-side size or execution limit, use FTP/SFTP instead of repeatedly retrying the same dashboard upload. The server route sends the extracted directory directly and therefore avoids the dashboard’s archive-upload step.
Free tools Windows power users keep installed
One-click scans. No signup required.
The ZIP uploads but activation fails
A completed transfer does not guarantee compatibility. Compare the installed WordPress and PHP versions with the WooCommerce requirements matrix, and check the recommended database versions as well. A release can have a minimum PHP version while WooCommerce recommends a newer one. Upgrade the environment through your host, or select a WooCommerce release compatible with the site’s supported versions when that is appropriate. Take a backup and test the change on staging before altering a live store.
WooCommerce files exist but the plugin is not listed
Inspect the remote path. The plugin must be directly under wp-content/plugins. A common mistake is a path such as wp-content/plugins/woocommerce/woocommerce, caused by uploading a containing folder that itself contains the real plugin folder. Move the directory so that the WordPress plugin file is inside wp-content/plugins/woocommerce, then refresh Plugins > Installed Plugins. Also verify that the transfer finished and that you did not upload a source repository’s top-level folder.
Activation reports a PHP or WordPress compatibility problem
Do not bypass the warning on a production store. Compare the installed WordPress and PHP versions with the WooCommerce requirements matrix, and check the recommended database versions as well. Upgrade the environment through your host, or select a WooCommerce release compatible with the site’s supported versions when that is appropriate. Take a backup and test the change on staging before altering a live store. Recheck the matrix whenever you choose a different WooCommerce release because requirements can change.
The site shows a fatal error immediately after activation
If you can still reach WP Admin, deactivate WooCommerce from the Plugins screen and review the error details with your host or developer. If the dashboard is inaccessible, use the host’s file manager or FTP/SFTP to temporarily rename the WooCommerce directory, which prevents WordPress from loading it; restore the original directory name after the compatibility or conflict is resolved. Use the backup if files or database changes need to be rolled back. Do not continue adding products or accepting orders until the site loads normally.
The Setup Wizard does not appear
Confirm that WooCommerce is active, then open its administration area from the WordPress dashboard. The wizard is associated with first activation; it may not reopen automatically if WooCommerce was previously activated or if setup was already dismissed. Complete the equivalent store settings manually in WooCommerce’s administration screens, and check that another plugin or a JavaScript error is not preventing the dashboard from loading. A missing wizard does not necessarily mean the plugin failed to install.
The server connection cannot write to plugins
Confirm that the FTP/SFTP account points to the correct WordPress installation and has permission to write to wp-content/plugins. If the account can browse but cannot transfer files, ask the host to correct the account permissions or perform the installation. Do not place files in a different directory merely because it accepts uploads; WordPress will only discover the plugin when it is in the documented plugins path.
Safe practices for future WooCommerce version changes
- Read the release requirements before replacing the installed ZIP with a newer release.
- Back up both site files and the WordPress database.
- Use a staging copy to test WooCommerce, WordPress, PHP, themes, and extensions together.
- Keep a record of the version you replaced so you know what to restore if activation or checkout fails.
- After an upgrade, test the administrator dashboard and the customer-facing store before accepting live orders.
- Keep the official ZIP or download record associated with the version you installed, especially for a Marketplace extension tied to a subscription or account download.
Manual installation is a file-delivery method; it does not remove the normal compatibility and change-management responsibilities of running an online store. A later version change should be treated as a controlled update, not as an opportunity to overwrite files without a backup.
Does manual installation require buying a physical product?
No. Core WooCommerce is installed as downloadable software in a ZIP archive. A physical book, accessory, or other product is not part of the installation process and cannot replace the plugin package. The only files needed are the official WooCommerce ZIP (or an extension ZIP when you are installing an extension), plus the appropriate WordPress or server access. The installation instructions do not establish a product price; any paid extension is obtained through its own WooCommerce account download and should be treated separately from core WooCommerce.
Frequently Asked Questions
Can I install WooCommerce without the automatic installer?
Yes. Download the official WooCommerce ZIP and use Plugins > Add New Plugin > Upload Plugin, or extract the ZIP and upload the woocommerce directory to wp-content/plugins with FTP/SFTP. Activate it from Plugins > Installed Plugins.
Should I unzip WooCommerce before using Upload Plugin?
No. Keep the official package as a single .zip for the WP-Admin upload route. Extract it only when using the FTP/SFTP directory method.
What is the correct FTP path for WooCommerce?
The final location is wp-content/plugins/woocommerce. Do not leave it nested as wp-content/plugins/woocommerce/woocommerce or upload the whole source repository.
What PHP and database versions does WooCommerce require?
WooCommerce recommends PHP 8.3 or newer and works with PHP 7.4 or newer. It recommends MySQL 8.0 or newer or MariaDB 10.6 or newer. Check the current release matrix for the exact WordPress and PHP minimums.
Why is WooCommerce not listed after an FTP upload?
Check that the extracted directory is directly inside wp-content/plugins, that the transfer completed, and that you uploaded the actual plugin directory rather than a containing folder or source repository. Refresh Installed Plugins after correcting the path.
What should I do if Upload Plugin is unavailable?
Use FTP or SFTP if you have server write access, then activate WooCommerce from the Installed Plugins screen. If you lack server credentials, the hosting or WordPress administrator must perform the upload.
Does activation configure my entire store?
First activation opens the WooCommerce Setup Wizard for basic store configuration. Payment, tax, shipping, email, and product settings still require separate review before accepting live orders.
Do I need to buy a physical product to install WooCommerce?
No. WooCommerce is downloadable software installed from a ZIP. A physical book, accessory, or other product cannot replace the official plugin package.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →The Bottom Line
Use the WP-Admin ZIP upload whenever it is available: Plugins > Add New Plugin > Upload Plugin > Install Now > Activate. If that route is blocked, extract the official ZIP, upload woocommerce directly to wp-content/plugins with FTP/SFTP, activate it, and complete the Setup Wizard. Check the current compatibility matrix and keep a backup before changing a live store.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
