Some checks failed
Tests / PHP 7.0 (push) Has been cancelled
Tests / PHP 7.4 (push) Has been cancelled
Tests / PHP 8.0 (push) Has been cancelled
Tests / Code Style (push) Has been cancelled
Sync Wiki / Sync Wiki to GitHub (push) Has been cancelled
Release / Build and Release (push) Has been cancelled
3.0 KiB
3.0 KiB
WordPress.org Plugin Assets Guide
This document provides detailed information about the assets required for the WordPress.org plugin repository.
Required Assets
Banner
The banner is displayed at the top of your plugin's page on WordPress.org.
- Regular Banner: 772x250 pixels
- Retina Banner: 1544x500 pixels
- Format: PNG or JPG
- File Names:
banner-772x250.{png|jpg}
andbanner-1544x500.{png|jpg}
Icon
The icon is displayed next to your plugin's name in search results and on your plugin's page.
- Regular Icon: 128x128 pixels
- Retina Icon: 256x256 pixels
- Format: PNG with transparency
- File Names:
icon-128x128.png
andicon-256x256.png
Screenshots
Screenshots are displayed in the "Screenshots" tab on your plugin's page.
- Size: At least 1200 pixels wide
- Format: PNG or JPG
- File Names:
screenshot-1.{png|jpg}
,screenshot-2.{png|jpg}
, etc. - Description: Screenshot descriptions are added in the
readme.txt
file under the "Screenshots" section
Asset Design Best Practices
Banner Design
- Keep it Simple: Don't overcrowd the banner with too much information
- Consistent Branding: Use colors and fonts that match your plugin's branding
- Readable Text: Ensure any text is large enough to read
- Purpose: Clearly communicate what your plugin does
- Avoid Small Details: Small details may not be visible at the displayed size
Icon Design
- Simple and Recognizable: The icon should be simple and easily recognizable
- Consistent with Banner: Use similar colors and style as your banner
- Works at Small Sizes: Ensure the icon is recognizable even at small sizes
- Transparent Background: Use a transparent background for the PNG
Screenshot Best Practices
- Show Key Features: Showcase the most important features of your plugin
- Logical Order: Arrange screenshots in a logical order that tells a story
- Clear and Focused: Each screenshot should focus on a specific feature
- Annotations: Consider adding annotations to highlight important elements
- Real-World Examples: Show the plugin in action with real-world examples
Uploading Assets
Assets are uploaded separately from your plugin code:
- Log in to your WordPress.org account
- Navigate to your plugin's page
- Click on the "Assets" tab
- Upload your assets using the provided interface
Asset Updates
When updating assets:
- Prepare the new assets following the guidelines above
- Log in to your WordPress.org account
- Navigate to your plugin's page
- Click on the "Assets" tab
- Upload the new assets
- It may take some time for the changes to appear on WordPress.org