What size is a WordPress plugin icon?

WordPress plugin icons require two sizes: 128×128 pixels (@1x) and 256×256 pixels (@2x for Retina displays). Both should be uploaded to your plugin's /assets/ directory in the WordPress SVN repository.

What size is a WordPress plugin banner?

WordPress plugin banners also require two sizes: 772×250 pixels (@1x) and 1544×500 pixels (@2x for Retina). These appear at the top of your plugin's page on WordPress.org.

Where do I put WordPress plugin images?

Upload your plugin icons and banners to the /assets/ directory in your plugin's WordPress.org SVN repository. Name them: icon-128x128.png, icon-256x256.png, banner-772x250.png, banner-1544x500.png.

Are my images uploaded to a server?

No. All processing happens entirely in your browser using the Canvas API. Your images never leave your device.

Can I use a JPG file for WordPress plugin icons?

WordPress.org accepts both PNG and JPG for plugin icons. PNG is recommended for icons because it supports a transparent background, which is useful if you want the icon to work on both light and dark themes. JPG is commonly used for banners.

Does WordPress.org accept SVG for plugin icons?

Yes. You can upload a single icon.svg file to your plugin's /assets/ directory, and WordPress.org will use it in place of the @1x and @2x PNG icons. SVG icons scale perfectly at any resolution and are the recommended modern approach for plugin icons.

WordPress Plugin Icon Generator — Icons for WordPress.org

Why Use This Tool?

WordPress.org is the world's most popular CMS, and the plugin directory hosts over 60,000 plugins. Your plugin's visual assets — icon and banner — are what developers and site owners see when browsing the directory. A professional icon and banner signal a well-maintained, trustworthy plugin and directly influence download rates.

WordPress Plugin Image Size Guide (2026)

Asset	Size (pixels)	File Name	Notes
Plugin Icon @1x	128×128	icon-128x128.png	Standard display
Plugin Icon @2x	256×256	icon-256x256.png	Retina displays
Plugin Banner @1x	772×250	banner-772x250.jpg	Plugin page header
Plugin Banner @2x	1544×500	banner-1544x500.jpg	Retina banner

Privacy First — 100% Client-Side

Your images are processed entirely in your browser using the HTML5 Canvas API. Nothing is uploaded to any server. You can verify this by disconnecting from the internet after loading the page — the tool works offline.

Tip: Upload your plugin assets to the /assets/ directory in your plugin's SVN repository (not in the plugin trunk). WordPress.org automatically serves the correct size for each user's display density. Use exact file names: icon-128x128.png, icon-256x256.png, banner-772x250.jpg, banner-1544x500.jpg.

Tips for WordPress Plugin Images

SVG icons are also supported at WordPress.org — a single icon.svg can replace both @1x and @2x PNG icons and scales perfectly at any resolution.
Banner design — the 772×250 banner is a wide, short format. Keep important text and branding in the center. The banner appears with your plugin name overlaid on the left side, so avoid placing content in the leftmost 250px area.
Color branding — many popular plugins use a consistent brand color in both the icon and banner background. This creates strong visual identity in the plugin directory.
Test at small sizes — plugin icons appear at 128×128 in search results. They must be clear, recognizable, and distinguishable from competitor plugins at that size.
Keep plugin assets simple — WordPress.org has a broad audience including non-technical users who respond to familiar, trustworthy-looking icons.