Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Guide

How to Install a WordPress Plugin

How to Install a WordPress Plugin

Short answer

Go to Plugins, then Add New, search for the plugin, click Install Now, then click Activate. You can also upload a ZIP file with the Upload Plugin button, install by SFTP into wp-content/plugins, or run wp plugin install with WP-CLI. Check the last update date, tested version and reviews before you install.

Key takeaways

  • The WordPress.org Plugin Directory is the best and safest place to get free plugins.
  • Installing a plugin and activating it are two separate steps; activation switches its code on.
  • Akismet and Hello Dolly come with a fresh WordPress install, and Akismet needs a key to run.
  • wp plugin install takes a slug, a local ZIP path, a remote ZIP address or a plugin page address.
  • Only an Administrator can install plugins; Editors cannot install themes or plugins.
  • Check the last update date, tested version, ratings and support replies before you install.

What is a WordPress plugin, and where do plugins come from?

A plugin is a small add-on that gives WordPress a new feature, and the safest place to get one is the official WordPress.org Plugin Directory.

Plugins add features such as contact forms, backups, SEO tools and shops. WordPress itself stays the same, and the plugin adds the code for the new feature. The guide to what a WordPress plugin is explains how plugins differ from themes.

The Learn WordPress Choosing and Installing Plugins lesson states that the WordPress Plugin Directory is the best and safest place to get free plugins. You can browse it on the web, or search it from inside your dashboard without leaving WordPress.

Two plugins come with a fresh install: Akismet and Hello Dolly. Akismet protects a blog from spam comments once you activate it with a key, as the same lesson states.

Premium plugins come from the vendor's own site as a ZIP file you download after you pay. Never install a plugin from a random download site, since a changed file can hide bad code.

You need an Administrator account to install plugins, since the Roles and Capabilities documentation gives Administrators access to all admin features on a single site. Editors cannot install plugins, as the Learn WordPress User management lesson states.

How do you install a plugin from the directory?

Go to “Plugins → Add New”, search for the plugin by name, click “Install Now”, then click “Activate”.

Follow these steps:

  1. Log in as an administrator.
  2. Go to “Plugins → Add New” in the left menu.
  3. Type the plugin name or a keyword in the search box.
  4. Check the plugin card: its rating, active installations, last update and compatibility line.
  5. Click “Install Now” on the card you want.
  6. Click “Activate” when the button changes.

The Learn WordPress Choosing and Installing Plugins lesson gives these exact steps, and adds that you should review the last updated date, downloads and compatibility first. A plugin with no update for a year and a low tested version is a warning sign.

Installing and activating are two separate steps. Installing copies the plugin files to your server, while activating switches the plugin on so its code runs. The Plugins screen documentation states that once a plugin is installed, you may activate it on the Plugins screen.

After activation, WordPress shows a “Plugin activated” notice at the top of the screen, as the Plugins screen documentation states.

The guide to how many plugins is too many for WordPress helps you decide whether to add one more.

The guide to free vs premium WordPress plugins covers when the paid version is worth it.

How do you install a plugin from a ZIP file?

Go to “Plugins → Add New”, click “Upload Plugin”, pick the ZIP file on your computer, click “Install Now”, then click “Activate”.

Follow these steps:

  1. Download the plugin ZIP file from the vendor and save it on your computer.
  2. Go to “Plugins → Add New” in the dashboard.
  3. Click the “Upload Plugin” button at the top of the page.
  4. Click “Choose File” and pick the ZIP file.
  5. Click “Install Now”.
  6. Click “Activate Plugin” when the install finishes.

The Learn WordPress Choosing and Installing Plugins lesson states that a vendor should give you a ZIP file when you buy a plugin outside WordPress.org, and that you install it through the dashboard upload. Do not unzip the file first, since WordPress expects the archive as it is.

The file must be a valid plugin ZIP with the plugin folder inside, or WordPress will reject it.

If the upload fails with a file-size error, the ZIP is larger than your host allows, so ask your host to raise the limit or use the SFTP method below.

How do you install a plugin with WP-CLI?

Run wp plugin install <slug> --activate from the server command line to install and activate a plugin in one step.

WP-CLI is the command-line tool for WordPress. The WP-CLI site states that anything you can do in the admin can be done from the terminal, including installing and updating plugins. It has shipped since 2011 and is kept up by the WordPress community.

Install a plugin from the directory by its slug:

wp plugin install contact-form-7 --activate

The wp plugin install documentation states that the command accepts a plugin slug, a local ZIP path, a remote ZIP URL, or a plugin directory URL. It also states that --activate installs and activates in one run, and --version fetches one exact release instead of the latest.

Install from a local ZIP file like this:

wp plugin install ~/Downloads/my-plugin.zip

Install from a remote ZIP file like this:

wp plugin install https://example.com/my-plugin.zip

The slug is the short name in the plugin's WordPress.org address, such as contact-form-7 in https://wordpress.org/plugins/contact-form-7/. Use the slug, not the display name, or the command will not find the plugin.

WP-CLI suits servers and agencies that manage many sites. You need SSH access to the server to use it.

How do you install a plugin by SFTP?

Unzip the plugin on your computer, upload the folder to /wp-content/plugins/ by SFTP, then activate it on the Plugins screen.

Follow these steps:

  1. Download the plugin ZIP file and unzip it on your computer.
  2. Connect to your site by SFTP with the details from your host.
  3. Open the /wp-content/plugins/ folder.
  4. Upload the plugin folder, with all its files, into that folder.
  5. Go to “Plugins → Installed Plugins” in the dashboard.
  6. Click “Activate” under the plugin name.

The WordPress Importer plugin page gives these manual steps for its own plugin: upload the folder to the /wp-content/plugins/ directory, activate it through the Plugins menu, then use it. The same steps work for any plugin.

The folder name must match the plugin slug, or WordPress may treat it as a different plugin on the next update.

Check the folder after the upload. A common error is uploading the folder inside another folder, so the plugin files sit one level too deep. The Plugins screen will not list the plugin at all if the folder is in the wrong place.

How do you check a plugin is safe before you install it?

Check the last update date, the tested WordPress version, the active installation count, the rating, and the support replies, all shown on the plugin's WordPress.org page.

The Learn WordPress Choosing and Installing Plugins lesson states that you should review the last updated date, the number of downloads and the compatibility line before you install. Those three checks catch most bad picks.

Work through this list on the plugin page:

  • Last updated: a plugin with no update for over a year may be abandoned.
  • Tested up to: the version the author last checked against. If it is far behind your WordPress version, the plugin may break on update.
  • Active installations: a high count means many sites run it, which is a weak but useful sign of trust.
  • Rating and reviews: read the one-star reviews first, since they name real problems.
  • Support: open the Support tab and check whether the author answers questions. Unanswered threads from months ago are a warning sign.
  • Source: install from WordPress.org or the vendor's own site only.

The guide to how to find abandoned WordPress plugins shows the warning signs of an abandoned plugin in full.

The guide to are nulled WordPress plugins safe explains why free copies of paid plugins are a bad idea.

The guide to how to check a plugin for vulnerabilities shows how to search public vulnerability reports before you install. Check your server too: WordPress.org's Requirements page recommends PHP 8.3 or greater.

How do you activate, update and delete a plugin?

Activate and deactivate from the Plugins screen, update from the “Update Available” filter or the Updates screen, and delete only after deactivating.

The Plugins screen documentation states that the screen manages activating, deactivating, updating, editing and deleting installed plugins. It lists every plugin in a table in alphabetical order, with filters at the top for All, Active, Inactive, Recently Active and Update Available.

To activate a plugin, click “Activate” under its name. To deactivate one, click “Deactivate”. Deactivating switches the code off without deleting its settings, so you can switch it back on later without setup work.

To update, open the “Update Available” filter and pick the plugins to update, or open “Dashboard → Updates” and update them in one place. The Plugins screen documentation states that Bulk Actions include Activate, Deactivate, Update and Delete, so you can update several plugins at once by ticking their boxes.

To delete a plugin, deactivate it first, then click “Delete” under its name. Deleting removes the plugin files, but it may leave its settings in the database.

What should you do when a plugin install fails?

Read the error message, check the cause in the table below, fix it, and try again, since most install failures come from limits, wrong files or a missing role.

Error or symptomLikely causeFix
“Installation failed: could not create directory”Folder permissions or a full diskAsk your host to fix permissions or free space
“The package could not be installed”Bad ZIP or wrong file typeDownload the ZIP again and do not unzip it
Upload fails with a file-size errorUpload limit too lowRaise the limit or install by SFTP
“Plugin activated” notice missingActivation failedRead the message at the top of the screen
No “Add New” buttonYour role cannot install pluginsLog in as an Administrator
“Destination folder already exists”An old copy is still thereDelete the old folder, then install again

The Plugins screen documentation states that a failed activation shows a message at the top of the screen, so read it first.

If a plugin breaks the site right after activation, deactivate it on the Plugins screen. If the dashboard will not load, rename the plugin folder by SFTP to switch it off.

What mistakes should you avoid?

Do not install plugins from unknown sites, do not install a plugin you have not checked, and do not leave inactive plugins on the site forever.

Other mistakes to avoid:

  • Installing two plugins that do the same job, which can clash.
  • Activating a plugin on a live site without a backup.
  • Ignoring the tested WordPress version on the plugin page.
  • Uploading an unzipped folder through the dashboard upload, which only takes ZIP files.
  • Keeping deactivated plugins for months, since old code can still be a risk.
  • Installing a plugin only because a guide told you to, without checking what it does.

Frequently asked questions

Do I need to activate a plugin after installing it?

Yes. Installing copies the plugin files to your server, while activating switches the plugin on so its code runs. You must activate a plugin before you can use it, and you can deactivate it later without deleting its settings.

How do I know if a plugin is safe to install?

Check the last update date, the tested WordPress version, the active installation count, the rating and the support replies on its WordPress.org page. A plugin with no update for over a year or many unanswered support threads is a warning sign.

Can an Editor install plugins in WordPress?

No. Only an Administrator can install plugins on a single site. Editors cannot install themes or plugins or approve updates. Log in with an Administrator account, or ask one to install it for you.

How do I delete a plugin I no longer need?

Deactivate it first, then click Delete under its name on the Plugins screen. Deleting removes the plugin files, but it may leave its settings in the database, so check the plugin's own documentation if you want those removed too.

Can I install a plugin with WP-CLI?

Yes. The command wp plugin install takes a plugin slug, a local ZIP path, a remote ZIP address, or a WordPress.org plugin page address. Add --activate to install and activate in one run, or --version to fetch one exact release.

Do inactive plugins slow down my site?

No. A plugin that is installed but not active does not run, so it cannot slow the front end. Even so, old inactive plugins can still be a risk, so delete the ones you will not use again instead of leaving them on the site.

Sources

  1. Choosing And Installing Plugins Learn WordPress
  2. Plugins screen WordPress.org
  3. wp plugin install WordPress Developer Resources
  4. Roles and Capabilities WordPress.org
  5. WordPress Importer WordPress.org
  6. WP-CLI WP-CLI

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.