New 24/7 monitoring and daily cloud backups now included in every Shield Pro plan.

Themes

How to install a WordPress theme from a ZIP file

Premium themes arrive as ZIP downloads from marketplaces or theme shops. The ZIP must unpack to a single theme folder with style.css in the right place or WordPress rejects the install.

Time: 15-25 minutes Level: Beginner

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.

Switching themes on a live site changes layouts immediately. Take a backup and note your current theme settings before activating a new design.

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

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

Upload via SFTP

Unzip the theme and upload the folder to wp-content/themes/ with FileZilla or your host file manager.

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

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.

Keep parent and child folder names lowercase with hyphens. Mixed casing breaks Template resolution on Linux servers.

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 SFTP.

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 fixed price when DIY imports stall.

FAQs

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 SFTP for large theme packages.

Rather someone else fixed it?

Request a fix at a confirmed price. Named UK developer, secure Vault, direct chat.

Request a Fix