Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Plugins Add New Screen

Plugins → Add New

The Plugins Add New Screen allows for the installation of new Plugins. Plugins extend and expand the functionality of WordPress. You may automatically install plugins from the WordPress Plugins Directory or upload a plugin in .zip format via this screen.

Back to Administration Screens.

The top section of the screen has 4 links (Featured, Popular, Recommended and Favorites) and Search Plugins box. The Featured page is active by default when you click into the Plugins - Add New menu.

Plugins Add New Screen

Search Plugins

If you know what you’re looking for, Search Plugins is your best bet. The Search function has options to search the WordPress Plugins Directory for a particular Keyword, Author, or Tag. Enter the word, or words, that can be used to search for the Plugin you would like to find. An example of a search keyword is backup. Hit the Enter key to initiate the Search. You will be presented with a table of Plugins under the Search Results link.

You can also search the directory by selecting popular tags at the bottom of Featured page. Tags in larger type mean more plugins have been labeled with that tag.

Search Results

Completing a search causes a new link to appear on the page called "Search Results" with Search type box allows for Keyword, Author, or Tag choices.

  • Search type - Pull down the box to select one of three searches types. Keyword searches plugins names and descriptions for the specified keyword, Author searches for plugins created by the Author, or which the Author contributed to, and Tag searches for plugins tagged as such.

Once that is selected, re-enter the word, or words, if required in the search box and hit the Enter key.

The Search Results page consists of a table with the Plugin Name, Descriptions, Author, star rating from users, Last Updated, compatibility with your WordPress version, action button and link to More Details information. There are 3 types of actions:

  • Install Now - When clicked, install the plugin immediately. Refer below #Install Now section.
  • Update Now - When the plugin is already installed but not the latest version, it is labeled as Update Now. Since WordPress Version 4.2, the update is conducted on the spot.
  • Installed - When the latest plugin is already installed, it is labeled as Installed, and deactivated.

If there are many Plugins found with your search, there will be Page Numbers at the top of the Table that will allow you to navigate to those pages. If you don't see the Plugin you wish to install, execute a new Search via the boxes at the top of the Table.

Install Now

If the Install Now is clicked for a Plugin in one of the search Tables, it will install the plugin and display messages similar to the following:

As part of a successful Plugin installation, two links are displayed:

  • Activate Plugin - Click this link to activate the Plugin just installed.
  • Return to Plugin Installer - Click this to be directed to the Plugins Add New Screen.

If you get prompted for ftp login information you can bypass this by setting the file permissions properly. See Updating WordPress for more details.

Upload Plugins

If you want to install a plugin that you’ve downloaded elsewhere, click the Upload link in the upper left. You will be prompted to upload the .zip package, and once uploaded, you can install the plugin.

  • Browse - Click to browse your computer's local hard drive and the select the Plugin zip file name is placed in the text box.
  • Install Now - Click this button to install the Plugin from the zip file detailed in the text box. Refer above #Install Now section.

Featured and Popular Plugins

If you just want to get an idea of what’s available, you can browse Featured and Popular plugins by using the links in the upper left of the screen. They produce similar tables to conducting a search. These sections rotate regularly.

Recommended Plugin

In a Recommend page, suggested plugins based on the plugins you and other users have installed are listed.

Favorites Plugin

WordPress Version 3.5 introduced the ability to display and easily install a user's favorite plugins from this Plugins Add New Screen. Click the Favorites link in the upper left of the screen. You can view the favorites of any wordpress.org user, by entering their username.

More information about plugin favorites:

See also Administration Screens and Network Admin.