how to upload your plugin to WordPress plugin directory

How to upload your plugin to WordPress plugin directory

This post has been viewed 106 times.

In this tutorial, I will guide you on how to upload your plugin to WordPress plugin directory.

As of this moment, there are currently around 54K+ plugins in the directory. Even though there is a vast number of plugins to choose from there are still instances that the functionality that you are looking for is not listed there and currently unavailable.

This makes it hard for non-developers that sometimes they will need to hire a developer just to have a certain functionality that they desire.

For developers, the WordPress plugin directory is the best place to host your own plugin. This can be a help to contribute to the WordPress community and a great exposure for your own works.

Just make sure that your plugin is needed and unique and it will become click.

What you’ll need:

  • A WordPress plugin created by yourself.
  • A account. (You can register here.)
  • TortoiseSVN installed on your computer or any SVN software. (You can download it here.)

Don’t have a plugin yet? You might be interested to read How to create a WordPress plugin.

Step 1: Create a readme.txt

The readme.txt file is the second most important file next to the code file in submitting your WordPress plugin. It holds information from basic to the detailed description of your plugin.

This file makes it easier for users to identify what does your plugin do and decide whether your plugin is worth downloading.

In short, this is where you market your plugin to the users.


The readme.txt above is what I use in my plugin Posts Unique View Counter.

1. The first line is where you will put your plugin name for this example the plugin name is Posts Unique View Counter.
2. Contributors are the username of the contributors for the development of this plugin. If you have more than one, you can separate it with commas.
3. The donate link is the link where can you receive donations.
4. The plugin name should be the same as number one (1).
5. The plugin uri is a valid url where they can see a detailed information about your plugin.
6. Tags are simply tags. Put the words you think that is related to your plugin.
7. The author uri is a valid link to the author page, you can put your own website or maybe your profile.
8. Author name is simply the name of the author.
9. Requires at least is the minimum version of WordPress required for your plugin.
10. Tested up to is the version of WordPress that you have tested it.
11. The version number is simply the number of versions. If you are just starting you can set it to 1.0, 1.0.0 or maybe alpha.
12. The stable tag is the version number that you can consider as stable.

You can just copy the license in here because one of the terms you have to follow when uploading your plugin is that its license must be GPL compatible.

The next is simply a short description of your plugin.

13. Then on the == Description == tag. Under it is the detailed information of your plugin. You can use HTML tags in here.
14. The == Installation == is your instructions on how to install your plugin correctly.
15. You can put Q&A in the == Frequently Asked Questions == if you have any of the users will not need to repeat questions that have been answered before.
16. == Screenshots == is the caption that will appear on your screenshots, it is matched by the number.
17. And finally, the == Changelog == is where you will put the changes for every version.
18. Icon.
19. Banner.

Figure 1.1

Picture 1.1. Screenshot 1.

Figure 1.2

Picture 1.2. Screenshot 2.

Figure 1.3

Picture 1.3. Screenshot 3.

Figure 1.4

Picture 1.4. Screenshot 4.

Step 2: Create an icon and a banner.

The icon and the banner will be displayed when it is approved in the directory.

The icon must be .jpg or .png and it is named in this format icon-128×128.jpg and icon-256×256.jpg it is better to have both of them. It must have a dimension of 128x128px and 256x256px respectively.

Same with the banner must be .jpg or .png and named banner-772×250.jpg and has a dimension of 772x250px.

If you ever have a screenshot it must also be .jpg or .png and a has a filename of screenshot-1.jpg, screenshot-2.jpg and so on. The caption that will be shown for this is in number sixteen (16).

Step 3: Zip the plugin file and the readme.txt

The zip file should look like this.

Inside the zip archive is a folder with the plugin name with no whitespaces (use dashes) then, inside the folder is your files.

Step 4: Submit your plugin for review.

Go to this link and upload the zip file you have created.

Add your plugin.

Picture 4.1. Add your plugin.


Pending Request

Picture 4.2. Pending request.

Step 5: Save your SVN repository link.

If your plugin is approved, then you will receive a congratulatory message containing your SVN repository link.

The link looks like this

congratulatory message

Picture 5.1. Congratulatory message.

Step 6: Upload your plugin to the SVN repository.

Open your TortoiseSVN Repository browser and enter your SVN repository link.

You should see four (4) directories.

The assets folder should contain the graphics for your plugin. You should upload the icon-128×128.jpg, icon-256×256.jpg, banner-772×250.jpg, screenshot-1.jpg, and the other screenshots if any.

The branches folder is like a playground where you can do testing of your code before releasing it.

The tags folder is like a folder for different versions of your plugin, just in case, your update fails then you can restore your plugin to the previous version uploaded in the tags folder.

The trunk folder is the live version of your plugin. This is where you will upload your plugin files together with your readme.txt file. The files you have submitted for review should be uploaded here.

Picture 6.1. Plugin files (left), svn repository (right)

Picture 6.1. Plugin files (left), svn repository (right)


File Upload

Picture 6.2. File Upload.

Right-click to the folder and click Add file to upload your file.

Enter a description for every file you upload

Picture 6.3. Enter a description for every file you upload.

That’s it, just make sure that you upload your file to the right directory and it should reflect almost immediately if you search for your WordPress plugin in the directory.

Hello, I am a freelance website and mobile application developer. I am also the owner of this website, so if you have any projects for me you can contact me at [email protected] or use the contact page. When I’m not doing some work, I can be found watching Anime/Asian Dramas/American TV Series, playing computer games, and writing tutorials on this website. I run the program repeatedly hoping the error won’t show up next time.