How to Install WooCommerce Plugin Manually

Installing WooCommerce manually gives you full control over the plugin files and is useful when the WordPress dashboard installer fails or you need to upload a specific version. This guide walks you through downloading the plugin, uploading it via the WordPress admin or FTP, and activating it successfully.

What You’ll Need

• A self-hosted WordPress site (not WordPress.com unless you have the Business plan).
• Admin access to your WordPress dashboard.
• FTP credentials (host, username, password) or access to your hosting file manager.
• The WooCommerce plugin ZIP file. Download it from the official WordPress.org repository or from your WooCommerce account if you have a subscription.
• A way to unzip files on your computer (for the FTP method).

Step-by-Step

1. Download the WooCommerce ZIP file. Go to the official WooCommerce page on WordPress.org and click the Download button. If you have a WooCommerce.com account, you can also download it from your account dashboard. Save the ZIP file to your computer.
2. Back up your site. Before installing any plugin, create a full backup of your WordPress files and database. Most hosting providers offer a backup tool, or you can use a backup plugin. This ensures you can restore if anything goes wrong.
3. Choose your installation method. You can install via the WordPress admin (easier) or via FTP (more control). Both are described below.

Method 1: Install via WordPress Admin

4. Log in to your WordPress dashboard. Go to wp-admin (e.g., yourdomain.com/wp-admin) and enter your credentials.
5. Navigate to Plugins > Add New. In the left sidebar, click on Plugins and then Add New.
6. Click the Upload Plugin button. It’s at the top of the page, next to the search bar.
7. Choose the ZIP file. Click Choose File, select the WooCommerce ZIP file you downloaded, and then click Install Now.
8. Wait for the installation to complete. WordPress will upload and unzip the file automatically. This may take a few seconds.
9. Activate the plugin. After installation, click Activate Plugin. You’ll see a success message and a WooCommerce setup wizard will appear.

Method 2: Install via FTP

4. Unzip the WooCommerce ZIP file on your computer. Extract the contents to a folder. You should see a folder named woocommerce.
5. Connect to your server via FTP. Use an FTP client like FileZilla. Enter your FTP host, username, and password (provided by your hosting company).
6. Navigate to the WordPress plugins directory. In the remote server panel, go to public_html/wp-content/plugins/ (or the equivalent path for your hosting setup).
7. Upload the woocommerce folder. Drag the folder from your local computer to the remote plugins directory. Wait for the upload to finish.
8. Log in to WordPress admin. Go to yourdomain.com/wp-admin.
9. Go to Plugins. In the left sidebar, click Plugins – you should see WooCommerce listed.
10. Activate WooCommerce. Click the Activate link below the plugin name. The setup wizard will then launch.

Common Mistakes

• Uploading the wrong file format. You must upload the ZIP file, not the extracted folder. If you upload a folder, WordPress will show an error.
• Using the wrong FTP path. If you upload to the wrong directory, the plugin won’t appear in your dashboard. Double-check that you’re in wp-content/plugins/.
• Not unzipping before FTP upload. With FTP, you must upload the unzipped folder. Uploading the ZIP file will not work because WordPress expects the plugin folder to exist directly in the plugins directory.
• Installing over an existing WooCommerce installation. If you already have WooCommerce, manually installing a new version can overwrite your settings. Always back up first and consider updating via the dashboard instead.
• Skipping the setup wizard. After activation, you need to complete the setup wizard to configure basic settings. Skipping it can leave your store in a non-functional state.

Tips

• Use the WordPress admin method whenever possible. It’s simpler and less error-prone than FTP.
• Check your PHP version. WooCommerce requires PHP 7.4 or higher. You can check this in your hosting control panel or via a plugin like Health Check.
• Keep WooCommerce updated. After manual installation, you’ll still get update notifications in your dashboard. Always update to the latest version to get security fixes and new features.
• Consider a staging site. If you’re adding WooCommerce to an existing site, test on a staging copy first to avoid breaking your live store.
• Use a child theme. If you plan to customize WooCommerce templates, use a child theme so your changes aren’t lost when you update the theme.

Troubleshooting

“The package could not be installed. No valid plugins were found.� This usually means the ZIP file is corrupt or not the correct plugin file. Re-download the ZIP from the official source and try again.

Plugin appears in FTP but not in the dashboard. Check that the folder name is exactly woocommerce and that it contains the main file woocommerce.php. If the folder is nested inside another folder, move it to the correct location.

White screen after activation. This is often due to a PHP error. Enable WP_DEBUG in your wp-config.php file to see the error message. Common causes are incompatible PHP versions or memory limits. Increase the memory limit by adding define('WP_MEMORY_LIMIT', '256M'); to your wp-config.php.

WooCommerce setup wizard doesn’t appear. You can manually start it by going to WooCommerce > Home in your dashboard. If it still doesn’t show, check that the plugin is active and that you have admin privileges.

FTP upload fails or times out. This can happen with large files. Try using the WordPress admin method instead, or ask your host to increase the PHP upload limits.

“Cannot modify header information� error. This is usually caused by whitespace or BOM in plugin files. Re-upload the plugin files, making sure your FTP client uses binary transfer mode.

Frequently Asked Questions

Do I need to unzip the plugin before uploading via WordPress admin?

No. WordPress handles the unzipping automatically when you upload the ZIP file via the admin. Only the FTP method requires you to unzip first.

Can I install WooCommerce manually on WordPress.com?

Only on the Business or eCommerce plans, which allow plugin installation. Free and Personal plans do not support plugins.

Will manual installation delete my existing WooCommerce data?

No, if you are installing WooCommerce for the first time, there is no data to lose. If you are overwriting an existing installation, your data is stored in the database and will remain, but it’s still wise to back up.

What is the difference between manual installation and automatic installation?

Automatic installation uses the WordPress repository and is simpler. Manual installation gives you control over the version and is useful when the automatic installer fails or you have a premium version.

How do I know if my server meets WooCommerce requirements?

Check the WooCommerce requirements page. The basics are PHP 7.4+, WordPress 6.0+, and MySQL 5.6+ or MariaDB 10.1+. You can also run the WooCommerce system status report after installation.

Can I install WooCommerce via FTP if I don’t have FTP credentials?

Yes, you can use your hosting provider’s file manager instead. Most cPanel or Plesk panels have a File Manager that lets you upload files directly to the server.

Related

• 1Password vs LastPass: Which Password Manager Is Better?
• Llama.cpp vs Ollama: Workflow, API, and Control
• Second-Level Domain: What It Means Before the TLD