Dear WordPress Plugin Developer, Please Add Screenshots

Plugin Recommendations Featured Image
photo credit: when i was a birdcc

This year the WordPress plugin directory crossed 35,000 plugin listings and is rapidly approaching one billion total downloads. WordPress 4.0 added custom icons to the plugin installer in the admin, which helps developers to differentiate their plugins in this massive sea of extensions. Plugin branding is useful for standing out in the initial results of a search, but beyond that there is one tab that gives plugins a distinct advantage over others.

How important is the Screenshots tab for plugins hosted on Feedback from our readers indicates that screenshots are a critical part of a understanding what a plugin does:

There’s nothing more infuriating than an incomplete plugin description with no screenshots. When you’re on the hunt for a specific functionality, it can be time-consuming to install a plugin, only to find out that it doesn’t do what you need it to do. For the plugin developer, there’s always the risk that someone will install your plugin, find out that it doesn’t do what they want, and give it a poor review because of the inconvenience.

Can Screenshots Make or Break a WordPress Plugin?

Many users now hunt for plugins in the admin, as opposed to directly on If you’re a plugin developer, it’s a good idea to remember that the plugin details page is still available to users searching in the admin via a modal window.

With the exception of plugins that have no visible output, every plugin listed in the directory could benefit from a set of basic screenshots. Some plugins, such as BuddyPress or Jetpack, have their own websites full of images. Even with a separate website, the plugins still include screenshots for users who don’t wish to navigate away from the admin or

If your plugin does something visual on the frontend, users appreciate a screenshot of an example, even if the output varies depending on the active theme. Frontend and backend screenshots are equally important.

For a simple plugin, with no dedicated website, having screenshots could be the difference between gaining a strong user base or having your plugin stuck at just a handful of downloads.

I’m borderline obsessive when it comes to the WordPress plugin directory. I have scanned through every single plugin that has come through the directory for the past several years, always on the hunt for the cream of the crop. Even with a solid description, if the plugin has no screenshots, it’s tough to find the motivation to take it on a test run. There are many gems hiding in the directory that have been overlooked and undervalued, simply because users cannot visualize how the plugin works.

If you are hosting a plugin on, there are three solid advantages to adding screenshots to your details page:

  • Screenshots help potential users understand what your plugin does: These images are an important part of your communication to the user. If you don’t care about communicating what your plugin does, why host it in a large, public repository where people will demand support?
  • Screenshots can reduce trivial support requests: There will always be people who install a plugin, without being sure of what it does. Having screenshots may help answer easy questions that would otherwise clutter up your support forums.
  • Screenshots may help your plugin gain traction and contributors faster: If a screenshot assists in clarifying what your plugin does, then you may inspire more people to install it, discover how awesome it is, write about it, and recommend it to others.

A plugin developer’s decision to omit screenshots is not necessarily indicative of the plugin’s future, but screenshots can go a long way towards building a solid user base that can make your plugin worth all the hard work you’ve put into it.

If you’re going through the trouble of putting your plugin up on, you might as well spend a couple extra minutes adding a few basic screenshots. Who knows? That plugin could be the key to your next paid gig and a valuable example of your work as an open source developer. Your plugin may even be the next most widely recommended tool for WordPress users, but the world may never know if you don’t bother to add any screenshots.


34 responses to “Dear WordPress Plugin Developer, Please Add Screenshots”

  1. What bugs me even more than not having screenshots is those plugin devs that don’t include a changelog or, even worse, only includes a link back to their site to view it. A built-in change log should be a compulsory requirement for the repository! Yes, BuddyPress, I’m looking at you!

  2. I agree. Screenshots of the backend admin panel and of the frontend of the site make all the difference. There have been so many times where I am not even sure exactly where to access the plugin because it can show up in several different locations on the backend.

  3. Thanks very much for this article. Agreed that screenshots and up-to-date changelogs are a must! So are detailed descriptions and FAQs. Plugin developers should be doing everything possible to communicate how their plugins work.

    To me, the worst is coming across a description with some variation of, “If you want to know more about this plugin, install it and test it out for yourself.” It’s so insulting to be asked to waste my time because a plugin dev was too lazy to write a few paragraphs explaining the plugin. If a plugin author can’t do that, it’s hard to believe that the person a) fully understands their own plugin; b) cares enough to maintain/update it. Theoretically, the plugin author should be in the best position to describe the plugin, and the inability or unwillingness to do so reflects strongly on the quality of the plugin and the kind of support that can be expected.

    It also conveys attitude towards free plugin users — it seems to say, “I’ve already done all this work for you to use for free so I don’t have to do anything else. If you want to use this, be my guest, but leave me alone.” It doesn’t exactly send the message that the plugin author cares to build relationships/business opportunities/etc.

    I guess where I’m going with this is that when plugin authors omit things like screenshots, detailed changelogs, and accurate descriptions, they seem to be showing disdain to potential users. I’m sure some of them do it because they’ve seen it done elsewhere and think it’s acceptable practice, or because they’re burned out from all the hours they spent developing the plugin in the first place and don’t have the energy left to explain what it does. Either way, the result is the same as if they truly were disdainful, and that’s a shame.

    Here’s to hoping this article will have an impact :) Thanks again!

    • I want to come to the defence of “wayward developers”.
      A lot of stuff goes into the plugin repository.
      Some plugins certainly merit a well thought out submission.
      Folks want to do all the aforementioned practices.

      But other plugins are outliers for many different reasons. Many require actual code investigation.
      Those plugins should have unique standards and when researching them one should take this into account when evaluating a plugin page.

      • I could almost buy that for certain niche utility plugins. But I still think quality is reflected and confidence instilled via the plugin documentation. For example, I recently came across the Delete Expired Transients plugin. Definitely niche and clearly an admin utility. One could easily say the name says it all – what more should be documented? Yet the developer includes screenshots and an explanation not only of what the plugin does, but why it is useful. (In fact, the writeup provides more background on expired transients than I could find on the codex.)

        Again, this reflects the quality of the plugin, and I could use it with more confidence than I would have otherwise (and, BTW, it happened to help me find another plugin I’m using has a transient leak).

  4. All very nice, until you try to find out how to do it. All Google searches result in people asking why their screenshots are not working. Trying to navigate to the *one* page that actually tells you how to add a screenshot is not easy.

    This article is a case in point – it says “just do it”, then provides no link to show how it is done.

    Even many other high-ranking articles that say “do add a screenshot, and here are some nice plugins that do”, then also fail to tell you how. And they all complain that developers are just not bothering. Why is it so hard?


Subscribe Via Email

Enter your email address to subscribe to this blog and receive notifications of new posts by email.