Skip to content
GPLWP Guides

How to manage WordPress plugin ZIP files

Utilities Time About 15 minutes per plugin 6 steps Updated 30 Oct 2026

UTILITIES
The short answer

For one plugin ZIP, use Plugins > Add New > Upload Plugin, choose the ZIP, install it and activate it. To update, upload the replacement ZIP; to remove it, deactivate the plugin first and then delete it. Use SFTP or WP-CLI when the dashboard upload fails or you have several files to handle.

The route
  1. 01Check the ZIP before uploading
  2. 02Install the plugin ZIP
  3. 03Update or replace a plugin
  4. 04Remove an installed plugin
  5. 05Use SFTP when upload fails
  6. 06Batch the job with WP-CLI

What you need

  • WordPress administrator access
  • A plugin ZIP file from a trusted developer
  • A current site backup before replacing or deleting a plugin
  • SFTP or SSH access if the dashboard method fails

Check the ZIP before uploading

Keep the original ZIP intact and check that it came from the plugin developer or another source you trust. WordPress expects a plugin package in .zip format when you use the dashboard uploader; do not extract it first.

If the download contains several ZIP files, read the developer's instructions and identify the actual installable plugin package. A common Friday-afternoon failure is uploading a documentation bundle, licence file or a ZIP nested inside another ZIP.

Install the plugin ZIP

In the WordPress dashboard, go to Plugins, open Add New, and select Upload Plugin. Choose the ZIP, click Install Now, wait for the success message, then select Activate Plugin.

If WordPress reports that no valid plugins were found, the archive may have the wrong folder structure, may not contain a plugin file, or may be the wrong download. Download it again and check the developer's installation notes.

Update or replace a plugin

Make a backup and check whether the ZIP is for the same plugin and a compatible version. WordPress supports installing or updating a plugin by uploading its ZIP from the plugin upload screen. After the operation, visit Plugins and confirm the expected version is active.

Do not casually delete the old plugin first just to make room. That can remove access to its settings or leave the site without an important feature. If an update breaks the site, restore the backup or use the original ZIP to reinstall the known-good version.

Remove an installed plugin

Go to Plugins, deactivate the plugin, and then choose Delete. Deactivation stops the plugin but leaves its files in place; deletion removes the plugin files.

Deletion does not always remove database tables, settings, uploaded files or content created by the plugin. Check the plugin's uninstall documentation before removing it permanently, and back up the site before manual cleanup.

Use SFTP when upload fails

When the dashboard cannot upload or unpack the ZIP, extract it on your computer and transfer the resulting plugin folder to wp-content/plugins with SFTP or your host's file manager. The extracted plugin folder, not the ZIP itself, must sit inside the plugins directory. Then return to Plugins and activate it.

Check your hosting upload limit, available disk space and file ownership if the transfer or unpacking fails. Do not overwrite files blindly on a live site if you have no backup or rollback plan.

Batch the job with WP-CLI

For repeated work, SSH users can install a local ZIP with wp plugin install /path/to/plugin.zip. WP-CLI also accepts a plugin ZIP URL and provides a --force option when you deliberately need to overwrite an installed version.

If you regularly need to queue or organise several plugin ZIPs inside the dashboard, control-zip may be worth considering. The available listing gives too little detail to confirm a distinct ZIP-management feature, so treat it as a low-confidence fit and verify its current functions before relying on it.

The fast route

Let control-zip do it

The listing provides too little detail to identify a distinct feature; this is a low-confidence ZIP-management classification.

Get control-zip

Sources

  1. wordpress.com /support/plugins/install-a-plugin/?utm_source=openai
  2. wordpress.org /documentation/article/manage-plugins/?utm_source=openai
  3. developer.wordpress.org /reference/functions/install_plugins_upload/?utm_source=open…
  4. wordpress.com /support/plugins/deactivate-or-delete-a-plugin/?utm_source=o…
  5. developer.wordpress.org /cli/commands/plugin/install/?utm_source=openai

Questions

Should I unzip a plugin before uploading it?
No. Keep the plugin as a ZIP when using Plugins > Add New > Upload Plugin because WordPress unpacks the archive during installation. Unzip it only when you are using SFTP or a host file manager, where you need to transfer the extracted plugin folder into <code>wp-content/plugins</code>. Uploading a folder or the wrong outer ZIP commonly causes an installation error.
Why does WordPress say the ZIP does not contain a valid plugin?
The ZIP is usually the wrong download, has an extra nested folder, contains only documentation, or lacks the plugin file WordPress expects. Re-download the package, inspect its contents, and follow the developer's installation instructions. If the dashboard still rejects it, extract the archive and install the plugin folder through SFTP, then activate it from the Plugins screen.
Can I update a plugin by uploading its ZIP?
Yes. WordPress's plugin uploader is intended to install or update plugins from ZIP files. Use the ZIP for the same plugin, back up the site first, and check the Plugins screen afterwards to confirm the version and activation state. If the update causes a fatal error, restore a backup or reinstall the previous known-good ZIP.
Does deleting a plugin remove all of its data?
No, not necessarily. Deleting the plugin removes its files, but settings, database tables, uploaded files and content can remain. Check the plugin's uninstall documentation before deletion, especially if you may reinstall it later. Make a backup before removing leftover data manually because deleting the wrong tables or files can damage other parts of the site.
What is the fastest way to manage several plugin ZIPs?
For a few files, use the dashboard uploader one at a time. For repeatable or server-side work, WP-CLI is faster because it accepts local ZIP paths and remote ZIP URLs. If you need a dashboard tool for organising multiple ZIP operations, control-zip is a possible fit, but the available listing does not provide enough detail to confirm exactly what it does.