What this problem is
Theme installation fails in Appearance > Themes > Add New, or via upload.
Why it happens
- Wrong ZIP uploaded (package contains docs and multiple zips)
- Server limits (upload size, execution time)
- Permissions prevent writing to
wp-content/themes
Prerequisites
- Admin access or FTP
- Theme ZIP from vendor
Diagnosis
Check the exact error text and confirm the ZIP contains a style.css and index.php in the theme root folder.
Detailed steps
Step 1) Verify you are uploading the theme ZIP
Some vendors provide an installable theme ZIP inside a larger download.
Step 2) Install via FTP if upload fails
Extract and upload the theme folder to:
wp-content/themes/Step 3) Fix permissions
Ensure the themes directory is writable.
Expected results
- Theme appears in Appearance > Themes and can be activated
What to do if it fails
- If you get a missing style.css error, follow the dedicated article for that error
- Ask hosting support to increase upload limits temporarily
Best practices
- Install from trusted sources and keep backups