Setup & site building · Guide
How to Install a WordPress Theme from a ZIP File (and Fix Upload Errors)

Short answer
To install a WordPress theme from a ZIP file, go to Appearance > Themes, click Add New Theme, then Upload Theme, choose the ZIP and click Install Now. When it finishes, click Activate or Live Preview. If the upload fails, make sure you uploaded the theme ZIP itself, not the full download package, and check your host's upload size limit.
Key takeaways
- Upload theme ZIPs under Appearance > Themes > Add New Theme > Upload Theme.
- Upload the installable theme ZIP, not the full package with docs.
- Use Live Preview before activating on a live site.
- SFTP and WP-CLI work when uploads are too large or blocked.
- Uploading a newer ZIP can replace an existing theme version.
How do you install a theme from a ZIP file?
Go to Appearance > Themes, click Add New Theme, choose Upload Theme, select the ZIP file from your computer, click Install Now, then activate or preview it.
This is how premium themes and themes from outside the WordPress.org directory are installed.
Free themes from the official directory can be installed by searching on the same Add New Theme screen, without downloading a ZIP at all.
The WordPress documentation for the Appearance Themes screen shows the upload and activation steps.
You need an administrator account to install themes.
On multisite networks, only network administrators can install themes, from the Network Admin themes screen. Site admins can then activate them.
Which ZIP file should you upload?
Upload the ZIP that contains the theme folder with style.css inside it; many marketplace downloads are a bigger package with documentation, licences and the real theme ZIP inside.
If you see an error saying the stylesheet is missing, unzip the download on your computer and look for the inner theme ZIP.
Theme ZIPs are usually named after the theme, while full packages often have words like package, bundle or the marketplace name in the file name.
Do not unzip the theme ZIP itself before uploading. WordPress needs the ZIP.
Some computers unzip downloads automatically. If you only see a folder, compress it again into a ZIP before uploading.
Child themes come as a separate ZIP. Install the parent theme first, then the child.
Activate the child theme rather than the parent once both are installed, so your customisations go into the child.
How do you preview before activating?
After installing, click Live Preview to see your content with the new theme without switching the live site, then activate only when you are happy.
Block themes open a preview in the Site Editor, while classic themes use the Customizer preview.
Should you install on a staging site first?
For established sites, yes. Install and configure the new theme on a staging copy, so visitors never see a half-finished design while you work.
Once it looks right, repeat the steps on live or push staging to live if your host supports it.
Check menus, widgets and the homepage, since they often need adjusting after a theme change.
Live Preview does not change anything for visitors, so you can explore freely. Close it without activating to keep the current theme.
Our guide on changing a WordPress theme covers everything to check before and after switching.
Why does the upload fail?
The most common reasons are the wrong ZIP, a file larger than the server's upload limit, a theme that already exists, missing files in the ZIP, or a PHP version the theme does not support.
| Error | Cause | Fix |
|---|---|---|
| Stylesheet is missing | Wrong ZIP uploaded | Find the inner theme ZIP |
| File exceeds upload limit | Server upload size too small | Raise limit or use SFTP |
| Destination folder already exists | Theme already installed | Replace or delete the old copy |
| Link you followed has expired | Upload or time limit hit | Raise limits or use SFTP |
| PHP version required | Theme needs newer PHP | Update PHP with your host |
Read the exact message. It usually names the problem clearly.
Why does the installation hang or time out?
Slow uploads and short server time limits can stop large theme uploads part way through, which often shows the link you followed has expired message.
Retry on a faster connection, ask your host to raise time limits, or use SFTP, which has no such limit and is often quicker for large files.
How do you fix the upload size limit?
Raise upload_max_filesize and post_max_size in your hosting panel or ask your host, or skip the browser upload and install the theme by SFTP instead.
The PHP manual explains the upload_max_filesize setting that controls this limit.
Media > Add New shows the current maximum upload size for your site.
Plugins that claim to raise the limit cannot exceed what the server allows, so a host setting change is often needed.
Large premium themes with demo content are the usual cause of this error.
Changing these limits in a php.ini or .user.ini file works on some hosts, but many shared hosts only allow changes through their control panel or support.
How do you install a theme with SFTP?
Unzip the theme on your computer, connect with an SFTP client, upload the theme folder into wp-content/themes, then activate it under Appearance > Themes.
The FileZilla documentation explains connecting and uploading folders.
Make sure the folder contains style.css directly, not another nested folder.
If you upload a folder inside another folder, WordPress will not detect the theme. Move the inner folder up one level.
This method avoids upload size and time limits completely.
Your host's file manager works the same way. Upload the ZIP there and use its extract option inside wp-content/themes.
How do you install a theme with WP-CLI?
Upload the ZIP to the server, then run wp theme install with the file path and the activate option from your WordPress folder.
wp theme install /path/to/theme.zip --activate
The wp theme install reference lists the options.
WP-CLI is handy for agencies installing the same theme on many sites.
WP-CLI can also install themes straight from the official directory by name, without any ZIP file.
How do you update a theme from a new ZIP?
Upload the newer ZIP the same way; WordPress detects the existing theme and offers to replace the current version with the uploaded one.
Back up first, since replacing a theme overwrites its files.
After replacing, clear caches and check the front end. Updated themes sometimes change default styles or templates.
Any edits made directly to the theme's files will be lost. Keep custom code in a child theme.
Our explainer on what a child theme is shows how to protect changes.
Where should you get theme ZIP files?
Download themes only from trusted sources: the official directory, the developer's own website or a reputable marketplace, never from sites offering free copies of premium themes.
Pirated or nulled themes often contain malware or hidden links.
They also miss updates and support, so security problems stay unfixed.
The free WordPress theme directory reviews every theme before listing it.
Check a theme's last update date, active installs and support forum before installing. Recent updates and responsive support are good signs.
Our comparison of free vs premium WordPress themes helps you decide which to buy.
What should you do after installing?
Activate the licence for premium themes, install any required plugins the theme recommends, import demo content only if you need it, and set up menus, logo and colours.
The licence key is usually in your account on the marketplace or developer site. Without it, updates and support may not work.
Required plugin notices appear at the top of the dashboard after activation.
Only install recommended plugins you actually need. Some themes suggest many optional plugins that add weight without real benefit.
Import demo content on a fresh site, not over existing content, to avoid clutter.
Demo images may have licences that only allow preview use. Replace them with your own images before launch.
Test the site on mobile after setup.
Run a quick speed test too. Heavy themes and demo content can slow a site noticeably.
How do you remove a theme you installed by mistake?
Switch to another theme, then open the unwanted theme under Appearance > Themes, click Theme Details and choose Delete.
You cannot delete the active theme.
Delete themes you do not use. Inactive themes still need updates and can carry security risks.
Our guide on removing WordPress themes covers deletion and leftover settings.
Keep one default theme installed as a fallback.
A clean, short list of themes also makes the Themes screen easier to manage.
WordPress switches to it automatically if your active theme ever breaks, which keeps the dashboard usable while you fix things.
Frequently asked questions
How do I install a WordPress theme from a ZIP?
Go to Appearance, Themes, Add New Theme, Upload Theme, choose the ZIP, click Install Now, then Activate or Live Preview.
Why does WordPress say the theme is missing style.css?
You probably uploaded the full download package. Unzip it on your computer and upload the inner theme ZIP that contains style.css.
What if the theme ZIP is too large to upload?
Raise the upload limit with your host, or unzip the theme and upload the folder to wp-content/themes using SFTP or your file manager.
Can I update a theme by uploading a new ZIP?
Yes. Upload the newer ZIP and WordPress offers to replace the current version. Back up first and keep custom code in a child theme.
Is it safe to install themes from any ZIP file?
No. Only use themes from the official directory, the developer's own site or reputable marketplaces. Nulled copies of premium themes often contain malware.
Sources
- Appearance Themes Screen WordPress.org Documentation
- upload_max_filesize PHP Manual
- Using FileZilla FileZilla Wiki
- wp theme install WP-CLI Command Reference
- Theme directory WordPress.org
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.


