Files
wp-fix-plugin-does-not-exis…/assets/WORDPRESS_ORG_SUBMISSION.md
Marcus Quinn 17d3d0946a
Some checks failed
ci/woodpecker/push/woodpecker Pipeline is pending
Build Release / Build and Create Release (push) Has been cancelled
Build Release / Deploy to WordPress.org (push) Has been cancelled
ci/woodpecker/tag/woodpecker Pipeline failed
Add properly named icon PNG files for WordPress.org submission (v1.6.24)
2025-04-12 19:02:50 +01:00

2.2 KiB

WordPress.org Plugin Submission Assets Guide

This document outlines the requirements for assets when submitting a plugin to the WordPress.org plugin repository.

Asset Requirements

Icon

  • Format: PNG
  • Size: 256x256 pixels
  • Filename: icon-256x256.png
  • Location: SVN /assets directory (not included in the plugin zip)
  • Optional: You can also include icon-128x128.png for backward compatibility

Banner

  • Format: PNG
  • Sizes:
    • Regular: 772x250 pixels (banner-772x250.png)
    • High-DPI: 1544x500 pixels (banner-1544x500.png)
  • Location: SVN /assets directory (not included in the plugin zip)

Screenshots

  • Format: PNG
  • Naming: Sequential numbers (screenshot-1.png, screenshot-2.png, etc.)
  • Location: SVN /assets directory (not included in the plugin zip)
  • Important: The number and order must match the descriptions in the readme.txt file

Current Status

Icon

  • SVG source available
  • PNG files created (icon-256x256.png and icon-128x128.png)

Banner

  • Both sizes available
  • Properly renamed versions created in assets/banner-png/

Screenshots

  • Only 1 of 3 referenced screenshots available
  • Need to create screenshot-2.png and screenshot-3.png
  • Properly renamed version of the first screenshot created in assets/screenshots-png/

SVN Directory Structure

When submitting to WordPress.org, your SVN repository will have this structure:

/assets/
    icon-256x256.png
    banner-772x250.png
    banner-1544x500.png
    screenshot-1.png
    screenshot-2.png
    screenshot-3.png
/tags/
    /1.0.0/
        [plugin files]
    /1.0.1/
        [plugin files]
/trunk/
    [current plugin files]

Action Items

  1. Convert the SVG icon to a 256x256 PNG file
  2. Create the missing screenshots (2 and 3)
  3. Ensure all files follow the proper naming convention
  4. Upload all assets to the WordPress.org SVN repository in the /assets directory

Resources