← All posts

How to Install a Premium WordPress Plugin From a ZIP File

WordPress GPL · November 9, 2026

Free plugins install from the WordPress directory with a search and a click. Premium plugins aren't in that directory: they arrive as a ZIP file that you upload yourself. This guide covers the three ways to do it (the dashboard, SFTP and WP-CLI), the errors people actually run into, and what to do when a freshly activated plugin asks for a licence key.

Before you start

  • Use an administrator account. On a multisite network, plugins are installed from the Network Admin by a super admin.
  • Check the requirements. The product description or the plugin's readme lists the minimum WordPress and PHP versions. Add-ons also need their parent plugin: WooCommerce extensions need WooCommerce, and Gravity Forms add-ons need Gravity Forms itself.
  • Back up a live site first. A plugin that clashes with something else can take a site offline, and a recent backup turns that into a quick restore.
  • Download the file and keep it zipped. On WordPress GPL, single purchases are listed under Downloads in your account; with a membership, open the product page and click Download now. Safari on a Mac unzips downloads automatically while its option to open “safe” files after downloading is switched on, so turn that off or use another browser.

Is it the installable ZIP?

Open the archive without extracting it. An installable plugin ZIP holds a single folder containing the plugin's PHP files, one of which starts with a header that includes a Plugin Name: line. If the top level shows several ZIP files, a documentation folder or licence files instead, you have the developer's full package. Extract that outer archive and use the plugin ZIP inside it.

Method 1: upload from the dashboard

  1. Go to Plugins → Add New Plugin (just Add New in older versions).
  2. Click Upload Plugin at the top of the screen.
  3. Click Choose File, select the ZIP, then click Install Now.
  4. When WordPress reports that the plugin was installed, click Activate Plugin.
  5. Open the plugin's settings screen. Some premium plugins launch a short setup wizard on first activation.

That covers most installs. If the upload fails, jump to the errors below or use one of the next two methods.

Method 2: upload over SFTP or your host's file manager

This route bypasses PHP's upload limits entirely, which makes it the standard fallback for large plugins.

  1. Extract the ZIP on your computer. You should get one folder named after the plugin.
  2. Connect to the site with an SFTP client, using the details from your hosting account. Prefer SFTP to plain FTP, which sends your password unencrypted.
  3. Open wp-content/plugins and upload the folder. The result should be wp-content/plugins/plugin-name/ with the plugin's files directly inside, not a second folder of the same name nested within it.
  4. In WordPress, open Plugins, find the new entry and click Activate.

Most hosting control panels also include a file manager. Upload the ZIP itself into wp-content/plugins and use its Extract option, which is far quicker than transferring hundreds of small files. If WordPress later reports permission problems, folders are normally set to 755 and files to 644.

Method 3: WP-CLI

If you manage sites over SSH, WP-CLI installs and activates a ZIP in one line:

wp plugin install ./plugin-name.zip --activate

Adding --force replaces an existing copy with the version in the ZIP, which is handy when rolling a newer release out to several sites.

Common errors and how to fix them

“The link you followed has expired”

Despite the wording, this usually means the file was larger than the server accepts. When an upload exceeds PHP's post_max_size, the request arrives empty and WordPress treats it as an expired link. PHP's own defaults are only 2 MB per file and 8 MB per request; many hosts raise them, but not all. The media upload screen shows your current limit as the maximum upload file size.

Raise upload_max_filesize and post_max_size in your host's PHP settings or, on hosts that support it, in a .user.ini file in the site's root folder:

upload_max_filesize = 128M
post_max_size = 128M
max_execution_time = 300

Changes in .user.ini can take a few minutes to apply. If you can't change the limits, use the SFTP method. The message “The uploaded file exceeds the upload_max_filesize directive in php.ini” has the same cause and the same fixes.

“The package could not be installed. No valid plugins were found.”

WordPress found no plugin header in the ZIP. You have almost certainly uploaded the full package rather than the plugin ZIP inside it, or a theme on the Plugins screen. Go back to the installable ZIP check above.

“Incompatible Archive”

The ZIP is incomplete or damaged, typically after an interrupted download. Download it again. If you had to re-compress a folder yourself, make sure the archive contains the plugin folder rather than its loose files.

“This plugin is already installed”

Not an error. WordPress has found an existing copy and shows the installed and uploaded versions side by side. Check the version numbers, then confirm the replacement with the button below the comparison. Settings live in the database, so they survive the swap, and WordPress warns you first if the uploaded version is older.

“Plugin could not be activated because it triggered a fatal error”

The code crashed while loading. The usual causes are a PHP version older than the plugin needs, a missing parent plugin or a conflict with another plugin. Check the requirements and make sure any parent plugin is active. To see the exact error, enable WP_DEBUG and WP_DEBUG_LOG in wp-config.php and read wp-content/debug.log.

A PHP or WordPress version error

If the plugin declares a minimum PHP or WordPress version that your site doesn't meet, WordPress refuses the upload and names the version required. Upgrading PHP is usually a setting in your hosting panel; try it on a staging copy first.

“Could not create directory”

WordPress isn't allowed to write to wp-content/plugins, or the disk is full. Your host can correct the file ownership, and the SFTP method works in the meantime.

There's no Upload Plugin button

Either your account isn't an administrator, you're on a multisite sub-site (use the Network Admin), your host has disabled plugin installation, or wp-config.php contains define( 'DISALLOW_FILE_MODS', true );, which turns off installing and updating from the dashboard.

Licence-key prompts after activation

Many premium plugins show a banner or a settings tab asking for a licence key or an account connection. That key belongs to the developer's own service: it lets their servers deliver one-click updates, support and any cloud features. It isn't part of a GPL copy, and our product pages say so in their “What's included” tab. In practice:

  • You can dismiss the notice and leave the field empty. The features that run inside WordPress generally don't depend on it.
  • Expect the developer's services, such as dashboard updates, support and remote template or add-on libraries, to be unavailable.
  • Don't paste in a key found online or install an “activator”. Leaked keys belong to someone else's account, and altered licence checks are what make a copy nulled, as our guide to GPL vs nulled plugins explains.
  • If you need the developer's support or cloud features, buy a licence from the developer. It works alongside the GPL copy rather than against it.

After installing

  • Keep the ZIP in a folder for that site. It is your way back if a later update misbehaves.
  • Note the version number shown on the Plugins screen.
  • Updates are installed the same way, by uploading the newer ZIP over the old one. Our guide to updating GPL plugins and themes adds backups, staging and rollbacks.

Stuck with a file you bought from us? Our support covers downloading and installing, so get in touch with your order number. If a file turns out to be broken and we can't provide a working copy, the refund policy lets you claim a refund within 14 days of purchase. And if you build sites regularly, a membership puts every plugin in the catalogue a click away.

Product names belong to their owners. WordPress GPL is an independent store and is not affiliated with or endorsed by the developers mentioned here.

FAQ

Do I need to unzip a plugin before uploading it?

Not for the dashboard: upload the ZIP exactly as downloaded. Unzip only for the SFTP method, where you upload the extracted folder.

Can I upload premium plugins on WordPress.com?

Only on plans that allow installing plugins. Elsewhere the Upload Plugin option isn't offered. Self-hosted WordPress has no such restriction.

Will replacing a plugin with a new ZIP delete my settings?

No. Settings are stored in the database and replacing the files leaves them in place. Deleting a plugin from the Plugins screen is different: some plugins remove their data when deleted.

How do I install a theme instead?

Themes go through Appearance → Themes → Add New Theme → Upload Theme and have quirks of their own, covered in our guide to installing a WordPress theme ZIP.

Comments

Be the first to comment.

Leave a comment

Comments are moderated before they appear.