Troubleshooting
WordPress Upload Theme Not Working: Causes and How to Fix It

Short answer
A theme upload usually fails because you uploaded the full marketplace package instead of the installable theme ZIP, the file is larger than your server's upload limit, or permissions block WordPress from unpacking it. Upload the correct ZIP, raise the PHP limits, or install the theme folder by FTP.
Key takeaways
- Upload only the installable theme ZIP, not the full download package.
- The link expired message usually means the file is above your upload limit.
- style.css must sit directly in the top folder of the ZIP.
- Only Administrators can install themes, and some hosts disable installs.
- FTP upload skips PHP limits and is the most reliable fallback.
Why is the WordPress theme upload not working?
A WordPress theme upload usually fails because the ZIP file is the wrong package, it is larger than your server allows, or the theme is missing its required files.
The error message you see is the best clue. WordPress gives different warnings for a bad ZIP, a file that is too big, a theme that already exists and a server that blocks the request.
Some problems are not errors at all. On WordPress.com, for example, theme uploads only appear on plans that allow plugins and custom themes, so the Upload Theme button may simply be missing.
Use the table below to match your message to the likely cause, then jump to the section that fits.
| What you see | Likely cause | First fix |
|---|---|---|
| The package could not be installed. The theme is missing the style.css stylesheet. | Wrong ZIP or nested folder | Upload the installable theme ZIP only |
| The link you followed has expired | File exceeds upload or POST limit | Raise upload_max_filesize and post_max_size |
| The uploaded file exceeds the upload_max_filesize directive | PHP upload limit too low | Increase the limit or upload by FTP |
| Destination folder already exists | Older copy of the theme is installed | Replace the theme or delete the old folder |
| No Upload Theme button | Missing permission or hosted plan limit | Check your role and plan |
| HTTP error or blank screen | Timeout, memory or security rule | Check error logs and server limits |
| Could not create directory | Wrong folder permissions | Fix permissions on wp-content |
How do you upload a theme the right way?
Go to Appearance, then Themes, click Add New Theme, choose Upload Theme, select the ZIP file and click Install Now.
That is the standard method in the WordPress themes documentation. After the install finishes, you can preview the theme or activate it straight away.
Only upload ZIP files. WordPress cannot install a theme from a RAR file, a 7z archive or an unzipped folder through this screen.
If you are new to this process, our guide on installing a WordPress theme from a ZIP file walks through each screen.
Why does WordPress say the theme is missing the style.css stylesheet?
This message means WordPress opened your ZIP file but could not find a style.css file with a theme header in the top folder.
The most common reason is that you uploaded the full download package from a marketplace. Those packages often contain documentation, licensing files, demo content and child themes, with the real theme ZIP tucked inside.
Unzip the download on your computer first. Look for a second ZIP named after the theme, such as themename.zip, and upload only that file.
The second common reason is a nested folder. If the ZIP contains a folder, which contains another folder, which holds style.css, WordPress will not find it.
The Theme Handbook explains that style.css must include a header comment with at least a Theme Name line. Without that header, WordPress does not treat the folder as a theme.
You might also be uploading a plugin by mistake. Plugin ZIPs belong under Plugins, then Add New Plugin, not under Themes.
For a deeper look at this specific message, see our guide to the stylesheet is missing error.
Why do you get “the link you followed has expired”?
The link you followed has expired message usually means the theme file is bigger than the upload or POST size your server allows, so PHP throws the request away.
Check your current limit first. In the Media, then Add New Media File screen, WordPress shows a line such as Maximum upload file size: 2 MB. Many premium themes are larger than that.
You can raise the limit in a few ways. Your host's control panel may have a PHP settings screen, or you can edit php.ini, .htaccess or wp-config.php depending on how the server runs PHP.
The settings that matter are upload_max_filesize, post_max_size, max_execution_time and memory_limit. The PHP manual on these directives explains each one, and post_max_size must be equal to or larger than the upload limit.
Our guide on increasing the max upload size covers the exact edits step by step.
If the message still appears after you raise the limits, read our guide to fixing the link you followed has expired for other causes.
If your host does not let you change these values, upload the theme by FTP instead. That method skips PHP's upload limits completely.
What if the theme already exists?
WordPress shows Destination folder already exists when a theme with the same folder name is already installed, which happens when you try to reinstall or update a theme by uploading it again.
Newer versions of WordPress handle this better. After the upload, you see a comparison screen with the current and uploaded versions and a button to Replace active with uploaded.
If you do not see that option, go to Appearance, then Themes, and delete the old copy first. You cannot delete the active theme, so switch to a default theme for a moment if needed.
Before you replace anything, back up your site. Settings stored in the Customizer usually survive, but any changes made directly to the theme files will be lost. That is why edits belong in a child theme.
Why is the Upload Theme button missing?
The Upload Theme button is missing when your user role cannot install themes, file editing and installs are disabled, or your hosting plan does not allow custom themes.
Only Administrators can install themes on a normal single site. On a multisite network, only the Super Admin can install them, and site admins only see themes the network has enabled.
Check wp-config.php for the DISALLOW_FILE_MODS constant. When it is set to true, WordPress hides all install and update buttons for plugins and themes. Some managed hosts set this on purpose.
On WordPress.com, uploading third-party themes needs a plan that supports plugins and themes. The WordPress.com support page on uploading themes lists what each plan allows.
Could server permissions or security rules block the upload?
Yes, wrong folder permissions or a firewall rule can stop WordPress from unpacking the ZIP, even when the file itself is fine.
A message such as Could not create directory or Installation failed points to permissions. WordPress needs to write to wp-content/themes and to the temporary upgrade folder.
The usual safe setting is 755 for folders and 644 for files, with the web server user owning them. Our guide to setting correct file permissions explains how to check this.
Security tools can also block uploads. ModSecurity rules on the server, a web application firewall, or a security plugin may flag large ZIP uploads, especially themes that include encoded files.
If the upload fails with a 403 Forbidden error or a generic HTTP error, ask your host whether a firewall rule was triggered. They can see the exact rule in the logs.
What if the upload times out or shows a blank screen?
A timeout or white screen during a theme upload usually means PHP ran out of time or memory while unpacking a large theme.
Raise max_execution_time to 300 seconds and memory_limit to 256M if your host allows it. Then try the upload again.
Turn on debug logging to see what went wrong. Our guide on enabling debug mode shows the wp-config.php lines to add, and the errors are then saved to wp-content/debug.log.
If the upload succeeded but the site breaks after activation, the theme may need a newer PHP version or a plugin it depends on. Check the theme's requirements before you activate it again.
How do you install a theme with FTP instead?
Upload the unzipped theme folder to wp-content/themes with an FTP or SFTP client, then activate it from Appearance, then Themes.
This route avoids every PHP upload limit, which makes it the most reliable fix when the dashboard upload keeps failing.
- Unzip the installable theme ZIP on your computer.
- Connect to your server with an SFTP client such as FileZilla or your host's file manager.
- Open wp-content/themes.
- Upload the theme folder, making sure style.css sits directly inside it.
- In the dashboard, go to Appearance, then Themes, and activate the new theme.
Many hosts also offer a file manager in the control panel. You can upload the ZIP there and extract it on the server, which is faster than sending hundreds of small files.
What should you check before contacting your host?
Before you open a ticket, confirm you are uploading the correct theme ZIP, note the exact error message, and check your current upload limit.
Run through this short list:
- Is the file a ZIP, not RAR or a folder?
- Does style.css sit in the top folder inside the ZIP?
- Is the file smaller than the maximum upload size shown in Media?
- Are you logged in as an Administrator or Super Admin?
- Does the theme support your WordPress and PHP versions?
- Did the same theme upload work on a staging copy?
Give your host the exact message, the file size and the time you tried. That helps them find the matching entry in the server logs quickly.
If the theme installs but still behaves oddly, our article on a WordPress theme not working covers problems that start after activation.
Frequently asked questions
Why does my theme upload say the package could not be installed?
WordPress could not find a valid style.css file with a theme header in the top folder of the ZIP. This usually happens when you upload the whole marketplace download instead of the theme ZIP inside it, or when the ZIP contains a nested folder.
What is the maximum theme size I can upload?
It depends on your server's upload_max_filesize and post_max_size values. WordPress shows the current limit on the Add New Media File screen. If your theme is larger, ask your host to raise the limit or upload the theme folder by FTP.
Can I upload a theme on WordPress.com?
Only on plans that support plugins and custom themes. On lower plans you can choose from the built-in theme library, but the Upload Theme option is not available. Check the current plan comparison on WordPress.com before upgrading.
Will reuploading a theme delete my settings?
Settings saved in the Customizer or the database usually stay in place when you replace a theme with a newer copy. Any edits made directly to the theme files are overwritten, which is why custom code belongs in a child theme.
Why does the upload work on one site but not another?
Different servers have different PHP limits, permissions and security rules. Compare the maximum upload size, PHP version and memory limit on both sites. A firewall or security plugin on one host may also block large ZIP uploads.
Sources
- Work with themes WordPress.org Documentation
- Main stylesheet (style.css) WordPress Developer Resources
- php.ini core directives PHP Manual
- Upload and set up custom themes WordPress.com Support
- FileZilla FileZilla Project
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.


