WordPress plugin assets match the readme install story
Treat icons, banners, and screenshots as part of the setup explanation, with image files and screenshot order that match the readme.
Why this can grow a startup
The WordPress plugin page is not just a text shelf. Search results, sidebars, and the plugin detail page all pull from asset files that have strict naming rules and long cache behavior. The docs also say there should be one screenshot for every line in the readme screenshot list. That is a useful operating constraint. If the icon is generic, the PNG fallback is missing, or the screenshot order does not match the story in the readme, the page looks less maintained than the code may actually be.
Company example
WordPress says SVG icons require a PNG fallback, plugin assets live in the top-level `assets` directory, screenshots should map one-for-one to the readme list, and image CDN updates can take from a few minutes to as long as six hours under load.
Source and metric
Source: WordPress Plugin Handbook: How Your Plugin Assets Work
WordPress requires one screenshot per readme screenshot line and says cached asset refreshes can take up to 6 hours under heavy load.
When to use it
Use this when Marketplaces, Brand, UX is relevant to plugin assets, screenshots, icon fallback and you can run a bounded test with a free budget.
When not to use it
Do not use it as a substitute for customer evidence, a clear owner, or a measurable stop condition. Local platform rules and market behavior still need checking.
Founder checklist
- Read WordPress Plugin Handbook: How Your Plugin Assets Work and identify what is directly supported.
- Choose one channel context: Marketplaces, Brand, UX.
- Define the test around WordPress requires one screenshot per readme screenshot line and says cached asset refreshes can take up to 6 hours under heavy load..
- Set an owner, evidence window, and stop condition before launch.
Explore the context
Apply this with an operator
Turn isolated search tactics into a crawlable visibility system tied to demand and proof.