How To Create an Awesome Page for Your Plugin

Originally published at:

You’ve just developed an awesome plugin for WordPress and you want to share it with as many people as possible. To do that, the platform seems to be the best choice as it’s the official WordPress plugins repository.

But submitting your plugin to is not enough to gain users: you must introduce your plugin in the best possible way to let WordPress users know what your plugin can do.

A complete page will make your plugin more attractive. You will gain more users and these users will know how to use your plugin.

Why Create a Good Plugin Page?

Once a WordPress plugin is installed, a short description can be displayed on the Installed Plugins page of the administration panel thanks to a correctly formatted comment, placed in the main file of the plugin. While this is a good way to help your users to remember what your plugin does, it doesn’t help you gain more users.

Before deciding to download your plugin, users generally check your plugin’s page in order to find out what it can do. Users will look at the description of your plugin, so you should describe precisely the features of your plugin (we will see how in a next part). But users will also want to know if your plugin is easy to use: several screenshots and a FAQ are useful for that. When you release an update, your users will want to know why they must download this update (does it fix known bugs or eradicate security risks?), so be sure to include this type of information as well.

Continue reading this article on SitePoint

Nice article, Jeremy.

Although not 100% related, it would be worth noting that you should also create two ‘icon’ files and place them in the ‘assets’ directory; sized 128x128 and 256x256, these icons are what’s shown in the plugins search screens within the WordPress dashboard itself.

  • icon-128x128.jpg
  • icon-256x256.jpg

Thanks, I didn’t find how to add these icons!

They go in to the ‘assets’ directory in the root of the repository.

This topic was automatically closed 91 days after the last reply. New replies are no longer allowed.