How to Install a WordPress Plugin from a ZIP File
Most premium plugins are not in the WordPress.org directory, so you install them from a ZIP archive instead of the built-in search. The whole thing takes about two minutes — here is the exact procedure, plus what to do when something goes wrong.
Before you start
- Check the ZIP itself. A valid plugin ZIP contains a folder with the plugin files, and inside it a main
.phpfile with the plugin header. If you open the archive and see another ZIP inside (common with bundles from marketplaces), extract the outer archive first and upload the inner plugin ZIP. If the file came from anywhere other than the developer’s own site, run the checks from our malware-check guide before uploading. - Note the size. Dashboard uploads are limited by your PHP
upload_max_filesizeandpost_max_size. If the ZIP is larger than the limit (often 8–32 MB on cheap hosting), use the FTP method below. - Back up. Installing a plugin is low-risk, but a quick backup — the free UpdraftPlus does it in two clicks — saves the day when a plugin conflicts with your theme.
Method 1: Upload through the dashboard
- Log in to
wp-adminand go to Plugins → Add New Plugin. - Click Upload Plugin at the top of the screen.
- Click Choose File, select the ZIP, then click Install Now.
- Wait for the “Plugin installed successfully” message and click Activate Plugin.
That is it. The plugin now appears in Plugins → Installed Plugins, and most plugins add a settings page under Settings or their own top-level menu.
Method 2: Install via FTP or the file manager
Use this when the dashboard upload fails or the file is too large.
- Extract the ZIP on your computer. You should get a single folder, for example
plugin-name. - Connect to your site with an FTP client (or your hosting file manager) and open
wp-content/plugins/. - Upload the whole extracted folder so the path looks like
wp-content/plugins/plugin-name/plugin-name.php. - In
wp-admin, go to Plugins → Installed Plugins and click Activate under the new entry.
Common errors and fixes
- “The uploaded file exceeds the upload_max_filesize directive.” Use FTP, or raise
upload_max_filesizeandpost_max_sizeinphp.ini/ the hosting panel and retry. - “The package could not be installed. No valid plugins were found.” You uploaded the wrong archive — usually a bundle that wraps the real plugin ZIP. Extract it and upload the inner ZIP.
- “Destination folder already exists.” A plugin with the same folder name is already installed. Deactivate and delete the old copy first — with one caveat: some plugins erase their own settings when deleted (their
uninstall.phproutine), so if the stored data matters, back up before you delete. Rename the new folder only if the plugin documentation says it is safe. - White screen or 500 error after activation. Rename the plugin folder over FTP to
plugin-name-off; WordPress will deactivate it automatically and the site comes back. Then check the PHP error log for the real cause — usually a PHP version mismatch.
After activation
Open the plugin’s settings page and configure the basics right away — many plugins ship with sane defaults but disabled key features. Finally, test the front-end of your site in an incognito window: layouts, forms and checkout should all behave exactly as before.