How to install a WordPress theme from a ZIP file

What this problem looks like

Theme ZIP errors usually mean nested folders. WordPress expects wp-content/themes/theme-slug/style.css, not wp-content/themes/theme-slug/theme-slug/style.css.

Marketplace downloads sometimes bundle documentation and licensing files outside the installable folder. Install only the folder that contains style.css.

Check the ZIP before upload

Extract the download on your computer.
Locate style.css and open it to confirm Theme Name and Version headers.
If you see Installable Theme Files Only, use that inner ZIP.
Reject nulled themes from unknown sources. They often contain malware.

Upload through wp-admin

Go to Appearance → Themes → Add New → Upload Theme.
Choose the ZIP and click Install Now.
Click Activate after install succeeds.
Install required plugins when the theme prompts you.

Upload via File Manager, SFTP, or FTP

Unzip the theme and upload the folder to wp-content/themes/ with File Manager, SFTP, or FTP.

Set folders to 755 and files to 644 unless your host documentation says otherwise.

Install with WP-CLI over SSH

Only run the command below if you have SSH access to the server. It will not work inside File Manager.

bash

wp theme install /home/user/Downloads/my-theme.zip --activate

Install child themes correctly

The parent theme must exist on the server before you activate a child. Upload the parent ZIP first, then the child ZIP.

Child style.css must declare Template: parent-folder-slug matching the parent directory name exactly.

Fix common upload errors

The package could not be installed often means wrong ZIP structure or file size limits. Increase upload_max_filesize in PHP or use File Manager, SFTP, or FTP.

Stylesheet is missing means style.css is not in the ZIP root folder WordPress expects.

When to stop DIY and hire help

Theme demo imports can fail on shared hosting limits. BugShield sets up premium themes and child themes at a confirmed fixed price when DIY imports stall.

Questions answered

Installing a WordPress theme from a ZIP FAQs

Answers about trusted theme files, parent and child themes, upload failures, backups, activation, and post-installation checks.

Can I install a theme while the old one is active?

Yes. Uploading does not switch the design until you click Activate.

Why does the theme look nothing like the demo?

Demos need one-click import, menus assigned, and bundled plugins active. Run the theme setup wizard completely.

Do I need a child theme?

Use a child theme when you add custom CSS or PHP so parent updates do not wipe your changes.

What is the maximum theme ZIP size?

It depends on PHP upload limits, often 2MB to 64MB. Use File Manager, SFTP, or FTP for large theme packages.

Where should I download a WordPress theme ZIP safely?

Use WordPress.org, the verified theme developer, or your licensed customer account. Avoid unofficial copies that may contain altered code or miss updates.

How do I know whether the ZIP contains a WordPress theme?

The installable folder should contain a valid style.css theme header and the required template files, not another product archive wrapped around it.

Do I install the parent theme before the child theme?

Yes. Install the required parent first, then install and activate the child theme so its customisations inherit the parent correctly.

Why does WordPress say the theme ZIP is too large?

The upload exceeds the PHP or hosting limit. Increase the approved limit, upload the extracted theme folder through SFTP, or ask the host for help.

Should I back up before activating a new WordPress theme?

Yes. A new theme can change templates, widgets, menus, and generated assets. Test it on staging and keep a current database and file backup.

What should I test after installing a WordPress theme?

Check menus, templates, forms, mobile layouts, accessibility, search, account pages, and the full WooCommerce basket and checkout journey where relevant.

Keep troubleshooting

Learn how to install a WordPress theme from a ZIP file.