No valid plugins were found 📝 WordPress

The package could not be installed. No valid plugins were found

The uploaded zip doesn’t contain a plugin main file with a plugin header at the expected level — often a zip of zips, a theme, or a source download.

Seen on: WordPress

Meaning

Marketplaces often ship a “full package” zip containing documentation and the actual plugin zip inside. GitHub source zips may nest the plugin in another folder or lack built files.

Common causes

  • Uploading the full download package instead of the inner plugin zip
  • Uploading a theme as a plugin (or vice versa)
  • Zip with an extra nested folder
  • Missing plugin header comment

⚡ Quick fix

  1. Unzip the package and upload the inner plugin zip
  2. Use Appearance → Themes → Add New for themes
  3. Ensure the main PHP file has the Plugin Name header

Detailed fix by platform

Shell

  1. unzip -l downloaded-package.zip | head

How to diagnose

  1. Zip — Contents and nesting
  2. Type — Plugin or theme?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.