What this problem is
WordPress reports Missing plugin header and the plugin cannot be activated.
Why it happens
- The plugin main PHP file does not contain a valid header comment
- You uploaded the wrong folder level (nested ZIP extraction)
- The plugin download is incomplete or corrupted
Prerequisites
- FTP/File Manager access
- Ability to re-download the plugin from the official source
Diagnosis
Open the plugin folder and identify the main plugin file (usually the one matching the plugin name). Check if it starts with a proper plugin header.
Detailed steps
Step 1) Fix folder structure
Ensure the plugin files are directly inside:
wp-content/plugins/plugin-folder/and not in:
wp-content/plugins/plugin-folder/plugin-folder/Step 2) Reinstall cleanly
Delete the plugin folder and upload a fresh copy from the trusted source.
Step 3) Validate the header
The main file must include something like:
/*
Plugin Name: Example
*/Expected results
- Plugin appears correctly in the Plugins list
- Activation works
What to do if it fails
- If it is a custom plugin, ask the developer to provide a valid header
- If it is a premium plugin, download again from the vendor portal
Best practices
- Install plugins from trusted sources only
- Avoid manually editing plugin code unless you maintain it