WordPress plugin banner size

Two files: banner-772x250 and banner-1544x500, as PNG or JPG. Each must be exactly the size in its name and no larger than 4 MB. They go in the assets folder at the top of your SVN repository, next to trunk, not inside it.

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

Standard
banner-772x250.png
High-DPI
banner-1544x500.png
Formats
PNG or JPG
Max. file size
4 MB

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.txt

A 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.

FileSizeUsed for
banner-772x250.png772 × 250 pxEvery screen. Required.
banner-1544x500.png1544 × 500 pxHigh-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/*.jpg

How 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.