How to Install a WordPress Plugin from a ZIP File

2 min read

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 .php file 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_filesize and post_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

  1. Log in to wp-admin and go to Plugins → Add New Plugin.
  2. Click Upload Plugin at the top of the screen.
  3. Click Choose File, select the ZIP, then click Install Now.
  4. 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.

  1. Extract the ZIP on your computer. You should get a single folder, for example plugin-name.
  2. Connect to your site with an FTP client (or your hosting file manager) and open wp-content/plugins/.
  3. Upload the whole extracted folder so the path looks like wp-content/plugins/plugin-name/plugin-name.php.
  4. 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_filesize and post_max_size in php.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.php routine), 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.