Troubleshooting
WordPress Theme Error Stylesheet Is Missing: Causes and How to Fix It

Short answer
The stylesheet is missing error means WordPress cannot find a valid style.css file at the top of your theme folder. It usually happens when you upload the full download package instead of the theme zip inside it, or when the zip has an extra folder layer.
Key takeaways
- Every WordPress theme needs a style.css file in its main folder.
- Most errors come from uploading the full download bundle, not the theme zip.
- An extra folder layer inside the zip hides style.css from WordPress.
- style.css must start with a header that includes Theme Name.
- Broken Themes means the theme's files are missing on the server.
What does “the theme is missing the style.css stylesheet” mean?
This error means WordPress could not find a valid style.css file at the top level of the theme you uploaded or installed, so it does not recognise the folder as a theme and refuses to install or use it.
The full message usually reads: The package could not be installed. The theme is missing the style.css stylesheet.
You may also see Stylesheet is missing in the Broken Themes list at the bottom of Appearance > Themes. That version means a theme folder exists on the server but its style.css is gone or unreadable.
Every WordPress theme, classic or block, needs a style.css file in its main folder. WordPress reads the header comment at the top of that file to learn the theme's name, version and author.
The main stylesheet documentation explains that this file is required for WordPress to detect a theme.
What causes the stylesheet is missing error?
The usual causes are uploading the full download package instead of the installable theme zip, a zip with an extra folder layer, uploading a plugin as a theme, a style.css without a proper header, or an incomplete upload.
| Cause | How to spot it | Fix |
|---|---|---|
| Uploaded the full download package | Zip contains docs, licences and another zip | Upload the inner theme zip |
| Extra folder inside the zip | style.css sits two folders deep | Re-zip the correct folder |
| Uploaded a plugin zip | Main file is a .php plugin file | Install under Plugins instead |
| Missing header in style.css | File exists but has no Theme Name | Add the header comment |
| Interrupted or partial upload | Files missing on the server | Re-upload the theme |
| Files deleted on the server | Theme listed under Broken Themes | Restore from backup or reinstall |
Most people hit the first cause, so start there.
Did you upload the full download package instead of the theme?
Premium themes often come in a larger zip that holds documentation, licence files, child themes and the real theme zip, so unzip the download on your computer and upload only the installable theme zip inside.
This is very common with themes bought from marketplaces. The file you download is a bundle, not the theme itself.
- Unzip the download on your computer.
- Look inside for a file named after the theme, such as themename.zip.
- Do not unzip that inner file.
- Go to Appearance > Themes > Add New Theme > Upload Theme.
- Upload the inner zip and click Install Now.
Some bundles include both a parent theme zip and a child theme zip. Install the parent first, then the child. Our explainer on what a child theme is covers how they work together.
Our guide on installing a WordPress theme from a zip file walks through the upload process in full.
Is there an extra folder inside the zip?
WordPress expects style.css to sit inside one theme folder at the top of the zip, so if the zip holds a folder within a folder, it cannot find the file and shows the error.
The correct structure looks like this:
mytheme.zip
mytheme/
style.css
functions.php
...
A broken structure looks like this:
mytheme.zip
mytheme-main/
mytheme/
style.css
This often happens with themes downloaded from GitHub or re-zipped by hand. To fix it:
- Unzip the file on your computer.
- Find the folder that directly contains style.css.
- Compress that folder on its own into a new zip.
- Upload the new zip.
On a Mac, right-click the folder and choose Compress. On Windows, right-click and choose Send to > Compressed (zipped) folder, or Compress to ZIP file on newer versions.
Did you upload a plugin instead of a theme?
If you uploaded a plugin zip on the theme upload screen, WordPress looks for style.css, does not find one and shows this error, so install the file from Plugins > Add New Plugin > Upload Plugin instead.
Page builders, add-ons and theme companion plugins are often mixed up with themes, especially when they come from the same vendor.
A quick check: open the zip on your computer. If the main file is a PHP file with a Plugin Name: header and there is no style.css, it is a plugin.
If you are unsure which is which, our explainer on themes vs plugins sets out the difference.
Does style.css have the required header?
A style.css file without a valid header comment is treated as missing, so make sure the file starts with a comment block that includes at least a Theme Name line.
A minimal valid header:
/*
Theme Name: My Theme
Version: 1.0
*/
For a child theme, add a Template line with the folder name of the parent theme:
/*
Theme Name: My Theme Child
Template: mytheme
*/
If the Template value does not match the parent folder name exactly, WordPress reports the parent theme as missing instead. Our guide on a child theme's style.css not working covers that case.
Learn WordPress has a short lesson on the main stylesheet if you build your own themes.
Save the file as plain UTF-8 text. Editors that add hidden characters at the start can stop WordPress from reading the header.
Was the upload incomplete or too large?
A failed or cut-off upload can leave a theme without style.css, so re-upload the theme, or upload it by FTP if your server's upload limit is too small for the zip.
Large themes can exceed the server's maximum upload size. That usually triggers a different message about file size, but a partial upload can leave a half-installed folder.
To install by FTP or file manager:
- Unzip the theme on your computer.
- Connect to your site with FTP or your host's file manager.
- Upload the theme folder to wp-content/themes/.
- Check that wp-content/themes/mytheme/style.css exists.
- Go to Appearance > Themes and activate it.
The upload limit is set by PHP's upload_max_filesize and post_max_size values, documented in the PHP core configuration reference. Your host can raise these if needed.
What if an installed theme shows Stylesheet is missing?
If a theme you already had now appears under Broken Themes with Stylesheet is missing, its files were deleted, moved or damaged on the server, so restore the theme folder from a backup or reinstall a fresh copy.
Common reasons:
- A security scanner removed infected theme files.
- A failed update left the folder half-written.
- Someone renamed or moved files by FTP.
- A migration did not copy every file.
If the broken theme is your active theme, your site may fall back to a default theme or show errors. Reinstall the same version, then check your customisations.
If this followed an update, see our guide on fixing a theme that broke after an update.
For other theme messages, our WordPress theme error guide covers the full range.
How do you fix the error step by step?
Open the zip on your computer, find the folder that directly contains style.css, upload only that folder as a zip or by FTP, and confirm the file has a valid Theme Name header.
- Unzip the download on your computer.
- If you see another zip inside, use that one.
- Make sure style.css sits directly inside the theme folder.
- Confirm the file is a theme, not a plugin.
- Check the style.css header has a Theme Name line.
- Upload through Appearance > Themes, or by FTP to wp-content/themes/.
- Activate the theme and check your site.
Free themes from the WordPress.org theme directory can be installed straight from the dashboard, which avoids zip problems entirely.
How do you avoid this error in future?
Download themes only from trusted sources, read the vendor's install notes, keep backups before installing, and test new themes on a staging site.
Before installing any theme from outside the official directory, it is worth checking it is safe. Our guide on how to check if a WordPress theme is safe explains what to look for.
Keep the original download somewhere safe too. If you ever need to reinstall, you will have the exact version that worked.
Frequently asked questions
Why does WordPress say the theme is missing the style.css stylesheet?
WordPress looks for a style.css file directly inside the theme folder in your zip. If it cannot find one, because you uploaded a bundle, a plugin, or a zip with an extra folder, it refuses to install the package and shows this message.
How do I fix this error with a ThemeForest theme?
Unzip the main download on your computer. Inside you will find documentation and a separate theme zip named after the theme. Upload only that inner zip through Appearance, Themes, Add New Theme, Upload Theme.
Do block themes need a style.css file?
Yes. Block themes still need style.css with a header comment that includes the theme name, even if most of their styles come from theme.json. Without it, WordPress will not recognise the folder as a theme.
What does Stylesheet is missing under Broken Themes mean?
It means a theme folder exists on your server but its style.css file is gone or unreadable. Files may have been deleted, quarantined or partly uploaded. Reinstall the theme or restore the folder from a backup.
Can I install a theme by FTP to avoid the error?
Yes. Unzip the theme on your computer and upload the folder containing style.css to wp-content/themes. This also helps when the zip is larger than your server's upload limit. Then activate it from the Themes screen.
Sources
- Main Stylesheet (style.css) WordPress Theme Handbook
- Main stylesheet lesson Learn WordPress
- WordPress Theme Directory WordPress.org
- PHP core configuration directives PHP Manual
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


