WordPress plugin icon size

Two square files: icon-128x128 and icon-256x256, as PNG, JPG or GIF, each no larger than 1 MB, in the assets folder of your SVN repository. You can add icon.svg as well, but only together with a PNG.

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

Standard
icon-128x128.png
High-DPI
icon-256x256.png
Vector
icon.svg + PNG
Max. file size
1 MB

The files

FileSizeNote
icon-128x128.png128 × 128 pxStandard
icon-256x256.png256 × 256 pxHigh-DPI screens
icon.svgany squareOptional, needs a PNG next to it

PNG, JPG and GIF are accepted under these names. The icon must be square. Like banners, the files go into assets/ at the top of your SVN repository, not into trunk.

SVG alone isn't enough

An SVG icon is allowed, but wordpress.org still needs a PNG for older browsers and for link previews on Facebook. Upload icon.svg together with at least icon-128x128.png.

If you don't upload one

wordpress.org generates an icon automatically, a geometric pattern in random colours. It marks the plugin as one whose author didn't get to the listing. Of the 100 newest plugins we checked in October 2026, 15 were showing a generated icon.

Where it appears

The icon is what people see before anything else: next to your plugin in the wordpress.org search results, and in the list of plugins inside WordPress when someone searches from their dashboard. In those lists it is shown well below 128 pixels.

Design for small

  • One clear shape. Details below a few pixels disappear.
  • No words. Your plugin name already sits next to the icon, and text is unreadable at that size.
  • Strong contrast with a white background, because that's what it sits on.
  • Design at 256 × 256 and export the 128 version from it, not the other way round.

If you change the icon and it doesn't show up, the same CDN cache applies as for banners: usually minutes, up to six hours around a major release.