A WordPress theme controls the presentation and template structure of a website. Installing a theme adds it to the site; activating it makes that theme responsible for the public design. Those are separate actions, which means you can install a theme without immediately changing what visitors see.
WordPress Theme Directory
Search, preview, and install a free directory theme directly from Appearance > Themes > Add New.
Upload a ZIP file
Use Upload Theme when a developer or marketplace provides an installable theme archive.
SFTP or file manager
Upload the extracted theme folder into wp-content/themes when dashboard installation is unavailable.
Before installing a theme
Verify the source
Use the official WordPress directory, the theme developer, or a reputable marketplace. Avoid modified “nulled” copies and unverified download sites.
Check requirements
Review the theme’s documented WordPress, PHP, plugin, ecommerce, accessibility, and browser requirements.
Create a backup
Back up the database and files, and confirm that the backup can be restored before changing a production design.
Use staging when possible
Test navigation, templates, forms, widgets, blocks, shortcodes, and integrations away from the live site.
Record the current layout
Capture menus, widget placements, homepage settings, logos, custom CSS, templates, and theme-specific options.
Confirm permissions
The account needs permission to install themes. Managed hosts and WordPress Multisite networks may restrict this capability.
Method 1: Install from the WordPress Theme Directory
Open the Themes screen
Sign in to the WordPress administration area and go to Appearance > Themes.
Select Add New
Use the Add New button to open the directory browser. Current interfaces may provide search, feature filters, popular or latest views, and a filter for block themes.
Review the theme
Open theme details, examine the description and screenshots, and use the available preview. Confirm that the design supports the site’s content rather than judging only the demo homepage.
Install the theme
Select Install. WordPress downloads and places the theme in the themes directory but does not necessarily activate it.
Preview or activate
Use a preview or staging environment when available. Select Activate only after the theme has installed successfully and you are ready to test the public site.
Method 2: Upload an installable theme ZIP
- Download the installable theme file. Keep the original archive and license information in a safe location.
- Open the upload screen. Go to Appearance > Themes > Add New > Upload Theme.
- Select the ZIP. Choose the installable theme archive—not a package containing documentation, plugins, multiple themes, or another ZIP layer.
- Select Install Now. WordPress extracts and validates the theme package.
- Review the result. Resolve any missing-parent, permission, PHP, or package errors before activation.
- Preview or activate. Test the site after activation and keep the previous theme installed until the switch is verified.
Use the correct ZIP level
When WordPress reports that the package could not be installed because the theme is missing style.css, the uploaded archive is often the wrong ZIP level or not a WordPress theme at all.
Method 3: Install through SFTP or a hosting file manager
Manual installation is useful when the dashboard upload limit is too small, installation is disabled, an interrupted upload must be repaired, or the administrator cannot access the Themes screen. Use SFTP or another encrypted transfer method when the host supports it.
- Download and scan the theme package. Obtain it from the legitimate source and keep an untouched copy.
- Extract the ZIP locally. The result should be one theme folder containing files such as
style.css. - Connect to the server. Use the host’s SFTP credentials or secure file manager.
- Open the themes directory. Navigate to the WordPress installation’s theme folder.
- Upload the extracted folder. Do not upload the ZIP itself into the directory and expect WordPress to extract it.
- Return to WordPress. Go to Appearance > Themes, verify that the theme appears, then preview or activate it.
Each installed theme should occupy its own folder. Avoid accidental nesting such as theme-name/theme-name/style.css, which may prevent WordPress from detecting the theme correctly.
Install parent and child themes correctly
A child theme requires its declared parent theme to remain installed. Install the parent first, install the child second, and activate only the child. See How to Create a WordPress Child Theme for the required Template header and update-safe customization workflow.
WordPress Multisite considerations
On a Multisite network, ordinary site administrators may be unable to install themes. A network administrator generally installs a theme and then enables it for the network or selected sites. If the Add New or Upload Theme control is missing, check the user role, network settings, and hosting policy rather than repeatedly attempting the upload.
What to check after activation
| Area | What may change | What to verify |
|---|---|---|
| Homepage | Template, hero, post feed, static-page handling. | Correct page is assigned and important content remains visible. |
| Navigation | Menu locations or Navigation block assignments. | Desktop, mobile, keyboard, current-page, and submenu behavior. |
| Widgets and sidebars | Widget areas differ between classic themes. | No content moved to inactive widget areas or disappeared. |
| Site Editor or Customizer | Available settings depend on theme type and support. | Logo, colors, typography, templates, header, and footer. |
| Content | Shortcodes, featured images, galleries, post formats, and theme-specific blocks. | Posts and pages remain readable without old theme dependencies. |
| Plugins and forms | CSS, templates, scripts, ecommerce, membership, and form layouts. | Submission, checkout, account, search, and error states. |
| SEO and sharing | Headings, schema, breadcrumbs, thumbnails, and archive templates. | One H1, canonical output, social images, pagination, and indexability. |
| Performance | Font, image, CSS, JavaScript, and block asset loading. | Mobile speed, layout stability, caching, and unused assets. |
Block themes and classic themes
After activating a block theme, Appearance > Editor provides the Site Editor for templates, template parts, navigation, and Styles. Classic themes usually rely more heavily on the Customizer, widget screens, PHP templates, and theme-specific options. The available Appearance menu changes with the active theme.
Do not assume a missing Customizer or Widgets menu means the installation failed. First identify whether the theme is block-based and review its documentation.
Customize without losing changes
Do not edit an installed parent theme directly when those changes must survive updates. Use supported Styles or Customizer controls, Additional CSS, a child theme, or a custom plugin depending on the type of change.
Troubleshooting installation errors
The Upload Theme button is missing
Confirm that the account has theme-installation capability. On Multisite, use the Network Admin. Managed hosting or security policies may disable file installation through the dashboard.
The package is missing style.css
Upload the installable theme ZIP rather than the complete marketplace download. Open the archive and confirm that the theme folder contains a root stylesheet with a valid theme header.
The uploaded file exceeds the server limit
Use SFTP, a hosting file manager, or ask the host to review the upload and PHP limits. Do not change server configuration blindly on a production site.
The destination folder already exists
A theme with the same folder name is already installed or a prior upload was incomplete. Back up the existing folder, compare versions, and use the normal update workflow or remove the incomplete folder only when it is safe.
The parent theme is missing
Install the required parent theme and leave it installed. Activate the child theme after WordPress recognizes the relationship.
WordPress requests connection information
The server may not allow WordPress to write directly to the themes directory. Use valid host credentials or ask the hosting provider to correct ownership and permissions rather than making the directory world-writable.
The theme installs but activation causes an error
Use the recovery method below, then review PHP compatibility, missing dependencies, incomplete files, fatal-error logs, and the theme developer’s requirements in staging.
Recover when a theme breaks the site
Open wp-content/themes and rename the active theme folder. WordPress can then fall back to another installed theme when one is available. After access is restored, inspect the error logs, restore the original folder name only when appropriate, and fix the underlying compatibility problem before reactivation.
Keep at least one current default theme installed as a recovery option. Do not delete the previous working theme until the new design has been fully tested and a rollback path is confirmed.
Remove themes you no longer need
After the new theme has been stable for an appropriate period, remove unused themes that are not required as a parent or recovery option. From Appearance > Themes, open Theme Details for an inactive theme and use Delete when available. Back up custom code before removal.
What changed from the original 2013 tutorial
The old article described Manage Themes and Install Themes tabs with Search, Upload, Featured, Newest, and Recently Updated views. Current WordPress consolidates these workflows under Appearance > Themes > Add New, with the exact layout changing over time.
The original page also described uploading an extracted folder into /wp-content/themes/ with FileZilla or Cyberduck. That method is preserved, with SFTP, ZIP-level checks, permissions, staging, multisite, activation testing, block-theme behavior, and recovery added.
Article status
Archived discussion
The original page included an inactive reply form but no preserved comments. The form has been removed so visitors are not asked to submit personal information to an endpoint that may no longer work.
Questions, corrections, and feedback about this tutorial can be sent through the redesigned TDWP contact page.