At WordPress.org plugin, is it possible to have screenshots in any other section rather than the screenshots section? For example. Can I create a section called "Manual" and then have some screenshots there?

  • What screenshot section?
    – s_ha_dum
    Commented Aug 9, 2013 at 2:21
  • Sorry.. i meant from the README.TXT file.
    – Daniel
    Commented Aug 9, 2013 at 2:31
  • That is even more confusing.
    – s_ha_dum
    Commented Aug 9, 2013 at 2:34
  • wordpress.org/plugins/about/readme.txt there you have the screenshot section. I would like to know if is possible to have other sections with screenshots.
    – Daniel
    Commented Aug 9, 2013 at 2:41
  • 1
    Ok. Got it. You are talking about hosting a plugin in the WordPress repo. Now it makes sense.
    – s_ha_dum
    Commented Aug 9, 2013 at 2:55

1 Answer 1


In the readme.txt file, the "Screenshots" section is a special section. The WordPress plugin repository checks your Assets folder (or the folder containing readme.txt) for images named in a certain way and corresponds them to the entries in this section. I don't believe it is possible to attach images in the same way in any other section.

Markdown does provide a syntax for including images:

![Alt text](/path/to/img.jpg)

However, I tried to make this work in the WordPress readme.txt validator, and I couldn't. It looks like the plugin repo strips these out, but I haven't actually tried it in a plugin's readme.txt and committed it to see what would happen.

  • Correct me if I'm wrong, but I don't think it looks in an assets folder. I'm pretty sure it looks in the same folder as the readme.txt file
    – shea
    Commented Aug 13, 2013 at 21:06
  • @bungeshea, it checks the /assets folder first for the screenshot images. If they aren't found there, it looks for the images in the folder containing the stable readme.txt. Take a look at the official readme.txt documentation, and scroll down to the Screenshots section for more details. I've edited the answer to clarify.
    – Ben Miller
    Commented Aug 14, 2013 at 3:14

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.