WordPress plugin screenshots: names, size and captions

Name them screenshot-1.png, screenshot-2.png and so on (PNG or JPG, lowercase, up to 10 MB each) and put them in the assets folder. Then add one caption per screenshot under == Screenshots == in readme.txt. wordpress.org doesn't require a pixel size.

Checked against the Plugin Handbook on November 22, 2026. Source

Names
screenshot-N.png
Formats
PNG or JPG
Max. file size
10 MB
Captions
readme.txt

Files and captions work as a pair

The number in the file name is what links a screenshot to its caption. Line 1 under == Screenshots == in your readme.txt becomes the caption of screenshot-1.png, line 2 the caption of screenshot-2.png, and so on.

== Screenshots ==

1. The settings page, where you choose which post types get suggestions.
2. Suggestions in the editor sidebar, ranked by relevance.
3. The report of links added over the last 30 days.

The images themselves go into assets/ at the top of your SVN repository. Screenshots have to be uploaded there: links to images hosted elsewhere aren't displayed. File names must be lowercase, so Screenshot-1.PNG won't be found.

Write captions that explain

A caption is the only text next to the image, so it should say what the screen does for the user, not just name it. "Settings" tells a visitor nothing; "The settings page, where you choose which post types get suggestions" does. In our benchmark of 3,445 plugins, 31 % of captions were shorter than 25 characters, which is usually a bare label.

What size?

There is no required size, only a 10 MB limit per file. What works well:

  • One aspect ratio for all screenshots. The gallery is easier to flip through when images don't jump in height.
  • Capture at double resolution. A 1280 × 800 browser window at 2× gives 2560 × 1600 pixels, which stays sharp on high-resolution screens.
  • Crop to what matters. Leave out the browser bar and the parts of wp-admin that aren't yours.
  • PNG for interfaces. Text and lines stay crisp. JPG is only better for screens that are mostly photos.

How many?

The median in our benchmark of 3,445 plugins is 5 screenshots. Among the 100 newest plugins in October 2026, 37 had none at all and 34 had fewer than 5. Show each main screen once, in the order a new user would meet them.

Screenshots in other languages

You can add a translated version with the language as a suffix, for example screenshot-1-de.png. It replaces the English image for German visitors. The caption is translated along with the readme on translate.wordpress.org.