How to install a WordPress plugin

This guide is another in the Inside WordPress series and will show you how to install a WordPress plugin. While this is a relatively simple task it is one of fundamental importance to WordPress and is often overlooked. As such it is a potential cause of problems to beginners, and not being able to successfully install plugins will prevent you from accessing the very large world of WordPress plugins.

The Third Man

There are three ways of installing a WordPress plugin:

  1. Automatically through WordPress – easiest, some server setup
  2. Manually uploading a plugin through WordPress – medium, some server setup
  3. Manually uploading a plugin via FTP – more complicated, no server setup

Automatically Installing a Plugin

This is by far the easiest method but it does require that your server is setup in such a way as to allow modifications to the plugin directory. This is beyond the scope of this guide, but it involves giving group/other write permissions to the wp-content/plugins directory. Once setup you will be able to press on the Add New plugin menu option:

Plugin Menu

On the Install Plugin screen you can then simply enter the name of the plugin into the search field and perform the search:

Search Plugin

The search results should then show the plugin. Clicking on install will automatically download and install the plugin onto your blog.

Search Plugin results

When finished you can then activate the plugin – everything is done and dusted!

Plugin installed

Manually Installing a Plugin

Downloading a Plugin

WordPress plugins are usually distributed as zip files. A zip file is a special file that allows you to store and compress many files together, resulting in a single file that is small and fast to download. Downloading a plugin consists of clicking the download link from the appropriate website and allowing the browser to store the file somewhere on your computer:

Download

Installing a downloaded plugin via WordPress

From the WordPress plugin menu click on Add New:

Plugin Menu

Instead of searching for a plugin you can directly upload your plugin zip file by clicking on Upload:

Upload zip

Use the browse button to select the plugin zip file that was downloaded, then click on Install Now. The plugin will be uploaded to your blog and installed. It can then be activated (see Automatically Installing a Plugin).

Installing a downloaded plugin via FTP

Once downloaded the file needs to be unzipped, a term that refers to the de-compressing and restoring to normal of a zip file. Depending what kind of computer you are using this is either a very simple stage, or one that requires additional software. Recent versions of Windows already understand zip files, as will OS X. If they don't then you will need to download and install something like 7-Zip, Winzip, or StuffIt.

When ready, unzip the plugin:

Unzipping on Windows

Now you will need to upload the plugin to your site using FTP. Before you continue you should have your FTP username and password available (these are the same details provided to you by your web host) and have installed an FTP client. For Windows you can use FileZilla, for Mac OS X you can use Cyberduck. Once you have the FTP software installed you should start it and open a new connection. Enter your FTP address, followed by your username and password:

Connecting to your website

After a few moments (if the address, username, and password are correct) you will be connected to your website and will see a directory listing.

Website directory listing

Navigate through this directory to where WordPress is installed. The exact location of this will change depending on your web host, but typically it will be inside a directory called public_html.

WordPress directory

Now navigate through WordPress to where the plugins are located: wp-content/plugins/

WordPress plugin directory

Now you can upload the plugin. Be aware that you need to upload the plugin directory as well as all files. Certain unzip applications will create a surrounding directory for you, which should not be uploaded. For example:

Correct (bold shows directory to be uploaded)

redirection/redirection.php

Incorrect

redirection/redirection/redirection.php
Uploading a plugin

When uploaded you need to activate the plugin.

Activating & Deactivating Plugins

When a plugin is installed it can be activated and deactivated quickly from the Installed Plugins menu:

WordPress plugin menu

You will be presented with a list of plugins. Locate your plugin and press activate or deactive. Simple!

Activating a plugin

Upgrading a Plugin

When an update for a plugin is available you will see a red indicator in the plugins menu:

Upgrade available

Clicking on this and then navigating to the Upgrade Available menu will display a list of plugins that can be updated. If this can be achieved automatically then selecting the upgrade automatically link will do this for you. If you want to manually update the plugin then you will need to follow the instructions above and re-upload the new version of the plugin. If you are using FTP then you are advised to delete the old plugin directory first – unless you have made modifications to the plugin files then all your settings and data will be retained.

50 Comments

  1. Joni Solis :

    Mar 6, 2008 4:41 pm | Reply

    You should add some info here about upgrading to a new version of a WordPress plugin.

    Like do you first deactive the plugin and then delete the old folder with the old files before you install the new folder and files? Or do your just overwrite the files in the old folder with the new files (after you deactive the plugin).

  2. Joni Solis :

    Mar 6, 2008 4:45 pm | Reply

    By the way, what WordPress plugins are you using for email notices of 'Subscribe to comments' and 'blog subscription'.

  3. John( author ) :

    Mar 11, 2008 2:47 pm | Reply

    A good idea Joni, I'll look into that soon. The subscribe to comments plugin is called 'subscribe to comments'! It's found at txfx.net. The blog subscription is of my own creation, and doesn't exist outside some experimental code.

  4. GoBabyGo :

    May 13, 2008 12:17 pm | Reply

    Yes ... and what if you have WP 2.5? Where do you activate the plug-in? Thx!

  5. KathiPeters :

    Jul 15, 2008 11:40 am | Reply

    I follow all of the steps listed above, but when I go to the list of plugins, it's not there. What am I doing wrong? I can't find anyone to help me.
    Thank you.

  6. John( author ) :

    Jul 15, 2008 2:38 pm | Reply

    It's hard to tell what you are doing wrong without seeing the process. if you followed all of the above steps and uploaded an unzipped plugin into your plugins directory then it will appear in the list.

  7. Compusure :

    Jul 28, 2008 10:23 am | Reply

    In some few cases when installing plugins it is necessary to install only the files within the downloaded folder to your plugins dir rather than the entire folder. This is pretty uncommon now though. The only example of such a plugin that comes to mind is the 'home-page-link.php' addon. I would read the readme.txt file that usually comes with the plugin and also make sure to refresh your plugins page after the install. You may also in some case, make sure that when you are uploading the files that they are uploaded in Binary format.

  8. hamydy :

    Aug 16, 2008 7:24 am | Reply

    hi i newbie in wordpress. my prolem is haw do i install plugin in normal wordpress acct. i didnt see any plugin in my acct.
    please help me

  9. Jessie :

    Sep 9, 2008 11:41 am | Reply

    hmmm. I've activated the plugin, but do not see a place to manage it. I have many plugins, but don't see it under settings, along with the others.

    help?

    thanks.

  10. Jessie :

    Sep 9, 2008 11:45 am | Reply

    found it under manage. plz disregard. thank you.

  11. Chris :

    Sep 11, 2008 8:11 pm | Reply

    Kathi,

    I had a similar problem with another plugin. You can try to upload the folder within the main folder of the plugin, which appears in your root directory. That worked for me with another plugin. It may work for this one too.

  12. Josh :

    Oct 7, 2008 6:13 pm | Reply

    Cool Tutorial. Is like if you want to explain someone how to take a shower. Extremly for Dummies ;-) . Anyway! how much time did you spent for that post

  13. Rav Kumar :

    Oct 9, 2008 1:55 pm | Reply

    Hi Nice to have plugin here. I have configured the plugin with the procedure you explained but it did not show any result. Can you please tell me what else should i need to check for making this work in my site????

  14. John( author ) :

    Oct 10, 2008 8:45 am | Reply

    Without knowing more about the plugin there is nothing else I can say. Remember that general wordpress support questions should be directed to the wordpress support forum.

  15. Katrina :

    Oct 24, 2008 7:36 pm | Reply

    Hi there - thanks for the tutorial. I get how to do everything you explain, and have installed and activated 3 plugins. The problem is...now what? Like - how does one see these plugins in order to use them in one's website? So looking at my website, I have the Calendar plugin. But where is it? How do I get to that page? There's no link, no module...nothing. Same with a form plugin I activated. It's installed. It's activated -- but it doesn't show up on the website. So it appears there's one step missing -- the finally step -- in the directions for noobies like me...HELP! Thanks!

  16. John( author ) :

    Oct 26, 2008 9:43 am | Reply

    Katrina, use of the plugins will depend entirely on the plugins themselves and you should consult the author's website for further details. Typically additional menu options are added into the WordPress administration pages.

  17. CakeBlast (Larry) :

    Nov 6, 2008 12:36 pm | Reply

    Good tutorial..if anyone ever needs to know how to upload in binary format using Filezilla, I wrote instructions and posted them to CakeBlast.

    ..partially in response to what Compusure said.

  18. Cody Clay :

    Nov 24, 2008 4:46 am | Reply

    Hi, Believe it or not there was a problem installing Drain Hole ... th following message appeared as anauthoritative looking comment as part of "Manage - Drain Hole" >>>>> Rendering of admin template /hermes/bosweb/web114/b1141/sl.clamclay/public_html/CC/wp-content/plugins/drain-hole/view/admin/holes.php failed

    How can I get it working?

  19. John( author ) :

    Nov 24, 2008 7:04 am | Reply

    Make sure you have uploaded the plugin correctly - you should have a drain-hole directory with files and sub-directories.

  20. stefano :

    Dec 3, 2008 12:26 pm | Reply

    Excuse me so much but I seguoto the procedure only when certain that on google for example one of my old post he gives me a blank page and not redirect me to the new url.
    What's wrong?
    Thank you very much

  21. John( author ) :

    Dec 4, 2008 4:19 am | Reply

    I don't know what you are referring to, Stefano

  22. Mario :

    Dec 17, 2008 4:44 pm | Reply

    As an Italian I reckon Stefano just used Bablefish or Google tanslate.. I think he was trying to say:

    "I followed your procedure but when I click on a SERP result for one of my old posts I get a blank page (404?) and does not redirect to the new page. "

    Hope I got it right and you can help him...

  23. Mario :

    Dec 17, 2008 4:52 pm | Reply

    ...and by the way...It works like a lucky charm... I spent all day on this and this is SWEEEEEEEEETTTT!!!! I'll donate.

  24. Boo :

    Mar 8, 2009 1:19 pm | Reply

    Hello!
    I'm new to all of this. Everytime I try to install a plugin to my wordpress I get headaches and I give up.
    I have a question.
    what's the username and password? it is my wordpress username? I have no clue. I have problems contecting the sever.
    I'll be greatful if someone helps.

  25. Casey :

    May 16, 2009 2:25 pm | Reply

    I just installed this plugin and I am following a tutorial where it instructs me to go to Manage -> Redirection -> Options

    I cant seem to find manage.... I have looked everywhere.

    Here is a snippet of the directions I am trying to follow

    Once you've done that, you'll want to install the Redirection plugin, and make sure that under Manage -> Redirection -> Options, making sure both URL Monitoring select boxes are set to "Modified posts". Now you can change those permalinks to perfectly SEO'd permalinks without having to do anything else, or worry about the search engine consequences.

    Any suggestions?

    • John( author ) :

      Jun 9, 2009 11:18 am | Reply

      Later versions of WordPress changed the menu name to Tools.

  26. Irwan M Santika :

    Jun 21, 2009 1:42 pm | Reply

    Thn'ks for your help, your post make me easy to install headspace plugin.
    once again thank you for your post. GBU

  27. rossdavidh :

    Jul 25, 2009 6:01 pm | Reply

    Thanks! That issue of the unzip creating an extra directory wrapped around the plugin was preventing this from working, and the (lack of) error messages wasn't giving me anything to go on to figure out why! Just ended a couple hours of frustration. Thank you thank you thank you!

  28. john :

    Sep 20, 2009 4:41 pm | Reply

    How do you get them to show up on the site, I already activated it i just can't find a place to add it to the site itself?

  29. Bob :

    Sep 27, 2009 5:50 pm | Reply

    Hello John,

    I have installed and activated the plugin but it is "not" showing up on the page. What am I doing wrong? Do I have to edit the page and enter some code so the plug in is displayed on the page?

  30. Gary Harmon :

    Jan 28, 2010 6:23 pm | Reply

    John,
    Is there a way to make the iframe taller than it is? On my webpage it is only about 2 to 3 inches. I would like to see it about 6".
    Gary

  31. Jesus Malave :

    Feb 4, 2010 9:25 am | Reply

    I am having the same problem ..I have installed the plugin but is not showing up on the page. Do you know why?????

  32. arbelzner :

    Feb 10, 2010 12:12 pm | Reply

    I have a dumb question, I am new to word press, i have got most of it working great but for some reason I have no idea how to access the gallery addon I have installed. It talks about shortcodes and gives me a list but i have no idea how to actually use them. I have googled how to use it and the only information that comes up is how to install( and that is the easy part) anyone have any ideas

  33. Nicolette Blando :

    Feb 15, 2010 11:27 am | Reply

    Hi. Do some Wordpress themes just not allow you to add a plugin or can you only add a plugin on a paid version of
    Wordpress? Honestly, I cannot find out how to upload a plugin anywhere in my administration menus. It's just not there.
    Any help would be greatly appreciated :)

    Thank you for your help!

    Nicolette

  34. angie :

    Apr 4, 2010 2:45 am | Reply

    Hello! I just upgraded to Wordpress and was wondering how to install some plug ins I had saved in my favs for a while. Thanks! Your directions worked perfectly. Although I feel a bit silly after seeing how easy it is. I guess if you just don't know it seems hard. Thanks again!!

  35. Bradley :

    Jul 26, 2010 6:24 pm | Reply

    When updateing a plugin, do you first deactivate the plugin and then delete the old folder with the old files before you install the new folder and files? Or do your just overwrite the files in the old folder with the new files (after you deactive the plugin)?

    • John( author ) :

      Jul 28, 2010 10:52 am | Reply

      Just overwrite the files - there's no need to deactivate anything. Even better, let WordPress upgrade it for you from the plugins page.

Pings & Trackbacks

carrero.es, steverenner.com, kuebasah.com, life4hire.berceloteh.com, sitepronews.com, frenzyseo.com, elitesuite.info, op111.net, waltervos.nl, niklassoderlund.se, searchenginepeople.com, searchenginepeople.com, pecciola.com, fabianschulz.net, thepixelboutique.com, seog.thinkdave.com,

Leave a Reply


XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Home | Main content | Software | Terms & Conditions | Sitemap | John Godley © 2010