{"id":17124,"date":"2015-05-05T22:53:32","date_gmt":"2015-05-05T22:53:32","guid":{"rendered":"http:\/\/developer.wordpress.org\/?post_type=plugin-handbook&p=17124"},"modified":"2025-01-31T16:39:24","modified_gmt":"2025-01-31T16:39:24","slug":"plugin-assets","status":"publish","type":"plugin-handbook","link":"https:\/\/developer.wordpress.org\/plugins\/wordpress-org\/plugin-assets\/","title":{"rendered":"How Your Plugin Assets Work"},"content":{"rendered":"\n

The assets<\/code> folder in your plugin is where you can store images (like plugin headers, icons, and screenshots) used on your plugin’s display page.<\/p>\n\n\n\n

All files should be placed into the assets<\/code> directory of your SVN directory and will work for all versions of your plugin. This is a top level directory, just like trunk<\/code>. You would not<\/strong> place the screenshots into trunk\/assets<\/code> or tags\/1.0\/assets<\/code>.<\/p>\n\n\n\n

All images are served through a CDN and cached heavily, so it may take a some time to update when changed or added. Please give the proxy some time to retrieve your images and cache them before reporting it\u2019s not working. It should only take a few minutes, but 6 hours is not unheard of when the servers are under high load (like the week before and during a release of a major version of WordPress).<\/p>\n\n\n\n

Default Image Sizes<\/h2>\n\n\n\n

Image sizes should be the same as implied by the names. That is, banner-772x250.png<\/code> should be 772 pixels wide by 250 pixels high. Similarly, icon-256x256.png<\/code> should be a 256×256 square.<\/p>\n\n\n\n

We have not<\/strong> defined any new banner sizes so please don’t try to be clever and rename yours thinking they’ll work. They simply won’t show. Similarly, don’t make your images larger (or smaller) and use the existing names. Things will look terrible.<\/p>\n\n\n\n

Plugin Headers<\/h2>\n\n\n\n

Plugin headers are those images you see at the top of a plugin page:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

When designing your header image, keep in mind the use of international plugin directories. Some of these, like Hebrew<\/a> and Arabic<\/a>, use Right-To-Left (RTL) languages. Ideally, design your banner such that the elements included in the image can be positioned from right to left or from left to right. You can create a different image for RTL pages, with -rtl<\/code> in the name.<\/p>\n\n\n\n

Filenames<\/h3>\n\n\n\n