How to Install a WordPress Theme (ZIP Upload)
Themes bought or downloaded outside WordPress.org arrive as ZIP archives. Installing one is quick, but themes have their own traps — here is the full routine plus the errors everyone hits the first time.
Before you upload
- Find the real theme ZIP. Marketplace downloads often bundle the theme with documentation, PSD files and child themes. The installable ZIP is usually named like
themename.zipand contains a folder withstyle.cssdirectly inside it. If the file came from anywhere other than the developer, check it for malware before uploading. - Check the requirements. Look at the required WordPress and PHP versions on the download page. A theme written for PHP 8 will white-screen a site on PHP 7.2.
- Back up — the free UpdraftPlus is enough — especially if you are replacing the active theme on a live site.
Method 1: Dashboard upload
- In
wp-admin, go to Appearance → Themes and click Add New Theme. - Click Upload Theme, choose the ZIP and press Install Now.
- After the success message you get three links: Live Preview, Activate and Go to Themes page.
On a production site, click Live Preview first. WordPress renders your real content inside the new theme without showing it to visitors, so you can catch broken menus and widgets before committing. Happy with what you see? Hit Activate & Publish.
Method 2: FTP / file manager
- Extract the ZIP locally.
- Upload the theme folder to
wp-content/themes/, givingwp-content/themes/themename/style.css. - In Appearance → Themes, hover the new theme and click Activate.
The two classic errors
- “The package could not be installed. The theme is missing the style.css stylesheet.” Nine times out of ten you uploaded the bundle, not the theme. Extract the download, find the inner ZIP (or the folder that actually contains
style.css) and upload that. Rarely, the archive has an extra nesting level —themename/themename/style.css— which you fix by re-zipping the inner folder. - “The uploaded file exceeds the upload_max_filesize directive.” Theme ZIPs with bundled demo media get heavy. Use the FTP method, or raise the PHP upload limits in the hosting panel.
After activation
- Reassign menus under Appearance → Menus — menu locations are per-theme.
- Check widgets: inactive widgets land in the “Inactive Widgets” area; drag them into the new theme’s sidebars.
- Set the homepage under Settings → Reading if the theme expects a static front page.
- Install the companion plugins the theme asks for (a notice usually appears at the top of the dashboard). Many “theme features” actually live in those plugins. If a companion ships as a ZIP file, the plugin installation guide walks through the upload.
- Import demo content only on fresh sites. Demo importers create dozens of posts and media items you will have to clean out of an established site.
Finish by walking through the front-end in an incognito window: home page, a post, a page, search results and the mobile menu. If the theme ships a child theme ZIP, activate the child instead — your CSS customisations then survive theme updates.