Where the files go
Banners, icons and screenshots live in one folder called assets at the top level of your SVN repository, alongside trunk and tags. They apply to every version of the plugin, so you can replace a banner without shipping a release.
your-plugin/
├── assets/ ← banners, icons, screenshots
│ ├── banner-772x250.png
│ ├── banner-1544x500.png
│ ├── icon-128x128.png
│ ├── icon-256x256.png
│ └── screenshot-1.png
├── tags/
│ └── 1.2.0/
└── trunk/ ← plugin code and readme.txtA common mistake is putting them in trunk/assets or inside a tag. wordpress.org doesn't look there, and the files end up in every user's download instead.
Why you need both sizes
The 1544 × 500 file is only shown on high-resolution screens, and only when a 772 × 250 file exists as well. On its own it is ignored. The easiest way is to design at 1544 × 500 and export a half-size copy.
| File | Size | Used for |
|---|---|---|
banner-772x250.png | 772 × 250 px | Every screen. Required. |
banner-1544x500.png | 1544 × 500 px | High-DPI screens, in addition |
JPG works under the same names (banner-772x250.jpg). Use PNG for flat colours and text, JPG for photos.
Exact size, exact name
The dimensions have to match the numbers in the file name, and no other sizes exist. A file called banner-1544x500.png that is really 1500 × 486 won't be displayed. Keep the names lowercase.
Make it readable at phone size
The banner shrinks with the page, so on a phone it is shown at a fraction of 772 pixels. Text that looks fine on your monitor becomes unreadable there. Use one line of large type, or none, and let the plugin name below the banner do the rest.
For right-to-left languages you can add banner-772x250-rtl.png. Language versions use the locale as a suffix, for example banner-772x250-de_DE.png. Only add them when they actually differ: a copy of the English banner under a German name just hides the original.
The new banner doesn't show
Assets are served through a CDN with heavy caching. A change usually appears within minutes, but around a major WordPress release it can take up to six hours.
If the image downloads instead of showing, SVN stored it with the wrong file type. Set it and commit again:
svn propset svn:mime-type image/png assets/*.png
svn propset svn:mime-type image/jpeg assets/*.jpgHow often is it missing?
Of the 100 most recently published plugins we looked at in October 2026, 27 had no banner. Their pages open without a header image, which is the first thing a visitor sees.