How to Install a WordPress Theme
To install a WordPress theme, log in as an Administrator, open Appearance → Themes → Add New Theme, then install a directory theme or upload the theme ZIP, and click Activate. If the upload fails, put the unzipped folder containing style.css into wp-content/themes and activate it from the Themes screen.
For WordPress site owners adding a free or premium theme and fixing upload errors along the way.
knowledge
- Read time
- 5 min
- Sections
- 7
- Updated
- 14 Nov 2026
- Written by
- WebJi® team
Last editorial update: 14 November 2026.
Three ways to install a WordPress theme
Install a free theme from the WordPress.org directory inside wp-admin, upload a theme ZIP you bought, or copy the theme folder into wp-content/themes when the upload fails; in every case the theme only goes live when you click Activate.
| Method | Use it when | Needs |
|---|---|---|
| Theme directory | The theme is free on WordPress.org | Administrator login |
| Upload Theme (ZIP) | You bought or downloaded a theme ZIP | Administrator login; ZIP under the upload limit |
| Manual folder | Upload fails, or the Add New button is missing | File Manager, SFTP or SSH access |
| WP-CLI | You manage the site over SSH | Shell access |
This guide covers self-hosted WordPress. If WordPress is not installed yet, start with installing WordPress. Installing a theme changes design, not content: posts, pages and media stay, though menus and widgets may need reassigning.
Install a free theme from the WordPress.org directory
Go to Appearance → Themes → Add New Theme, search or filter, click Install, then Activate.
- Log in at
/wp-admin/as an Administrator; Editors cannot install themes. - Open Appearance → Themes → Add New Theme.
- Search by name or filter by features such as block editing or accessibility; use Preview to try it on sample content.
- Click Install, then Activate.
- Open the site in a private window to confirm the new design.
Directory themes list the minimum WordPress and PHP versions they need; WordPress blocks installation if your site does not meet them. Shortlists are in the best free WordPress themes.
Upload a premium theme ZIP
Use Appearance → Themes → Add New Theme → Upload Theme, choose the ZIP that contains only the theme, click Install Now, then Activate. Do not unzip it first; WordPress unpacks it.
- Pick the right ZIP: marketplace downloads often bundle documentation, licences and child themes. Upload the inner theme ZIP whose top folder contains
style.css. - Updating a theme by upload: since WordPress 5.5, uploading a newer ZIP of an installed theme offers "Replace active with uploaded", showing the current and new versions first.
- Licence keys: premium themes usually ask for a key in their own settings page to enable updates.
Install a WordPress theme manually through File Manager or SFTP
Upload the unzipped theme folder so that wp-content/themes/theme-name/style.css exists, then activate it in Appearance → Themes. This bypasses the dashboard's upload size limit.
- Unzip the theme on your computer and check that
style.csssits directly inside the theme folder, not in a second nested folder. - Open the hosting File Manager (see how to access cPanel) and go to
public_html/wp-content/themes. - Upload the ZIP there and click Extract, or upload the folder over SFTP; the cPanel File Manager guide covers both.
- In wp-admin, open Appearance → Themes and click Activate.
Use SFTP on port 22 rather than plain FTP on port 21, which sends passwords unencrypted; the difference is explained in FTP vs SFTP.
Install and activate a theme with WP-CLI
Over SSH, wp theme install accepts a directory slug, a ZIP URL or a local ZIP file, and --activate switches to it in the same command.
# from the WordPress.org directory
wp theme install twentytwentyfive --activate
# from a ZIP you uploaded
wp theme install ~/uploads/my-theme.zip --activate
# check what is installed and active
wp theme list --fields=name,status,versionAfter activating: demo content, customising and child themes
A freshly activated theme often looks empty because it does not include your text; set a homepage under Settings → Reading, then customise in the Site Editor (block themes) or Appearance → Customize (classic themes).
- Demo import: optional; it copies the seller's sample pages and settings and can overwrite your homepage. Run it only on a new site or after a backup.
- Block vs classic: block themes are edited in Appearance → Editor; classic themes use the Customizer, Menus and Widgets screens.
- Code changes: edit PHP or CSS files only in a child theme, because a parent update replaces its files. Customizer and Site Editor settings are stored in the database and survive updates.
- Clean up: delete themes you do not use, keeping one default theme as a fallback; see deleting a WordPress theme.
When a WordPress theme will not install
Read the exact message on screen; each common error points to one cause.
| Message | Cause | Fix |
|---|---|---|
| "The theme is missing the style.css stylesheet" | Wrong ZIP (bundle or nested folder) | Upload the inner theme ZIP |
| "The uploaded file exceeds the upload_max_filesize directive" | PHP upload limit too low | Raise the limit or install manually; see increasing the upload size |
| "The link you followed has expired" | Upload took longer than PHP allows, often a large ZIP | Install manually, or raise post_max_size and execution time |
| "Destination folder already exists" | Theme already installed | Use "Replace active with uploaded", or delete the old folder |
| Requires a newer PHP or WordPress version | Site below the theme's minimums | Update WordPress or switch PHP version in the panel |
| White screen after activating | PHP error in the theme | Rename the theme folder to fall back to a default theme |
On WebJi® WordPress hosting, email support@webji.services with the exact message and the theme name; support replies 24/7 in Hindi and English, on average within 60 minutes.
Frequently asked questions
Will changing my theme delete my posts and pages?
No. Content lives in the database and stays. What can change is the layout, widget areas, menu locations and any shortcodes or blocks that belonged to the old theme. Preview the new theme first; changing a WordPress theme lists what to check.
Why is there no Add New Theme button?
You are not an Administrator, it is a Multisite where only the network admin installs themes, or DISALLOW_FILE_MODS is set in wp-config.php. Ask the site owner or host, or install the theme manually if you have file access.
Are nulled or free copies of premium themes safe?
No. Pirated premium themes frequently contain hidden backdoors or spam links, and they receive no security updates. Use the official free version, a free directory theme, or buy a licence from the developer.
Can I install a theme without activating it?
Yes. An installed but inactive theme does nothing to the live site. You can preview it in Appearance → Themes → Live Preview before activating, which lets you check menus and widgets first.
Checked 15 November 2026 against WordPress and WP-CLI documentation · Reviewed by the WebJi® team, Jaipur.
Ready to get started with WebJi®?
Join 12,000+ businesses across India and overseas. INR pricing, 18% GST shown before payment and 24/7 email support in Hindi and English — average first reply under 60 minutes.