Essential Techniques for WordPress Theme Installation

When you add a theme to a WordPress site, WordPress copies its files into the folder where the site stores themes. The theme becomes active only after you select it. Selecting the theme changes how pages look and which features appear, so install and activate a theme as separate steps.

Choose an installation method that fits where the theme came from and how you access the site. Before you activate it, check that WordPress recognizes the theme and preview it with your existing content. This helps you catch folder problems and see how the theme changes menus, widgets, and page layouts before visitors do.

Prepare before installing

Check the theme provider’s installation instructions and requirements first. A purchased theme might come as a ZIP file, while you can install a theme from the WordPress Theme Directory directly through the dashboard. Some providers include extra files in the download, so make sure your ZIP file contains the theme itself. The download may also include documentation or other files.

Back up the site’s files and database before changing its active theme. The files contain the theme and other site code, while the database stores content and settings. A complete backup includes both, as explained in WordPress’s backup guidance. If possible, install and test the theme on a staging site, which is a separate copy of the site for checking changes before they reach the live site.

Themes in the WordPress Theme Directory have passed a review against the directory’s rules. The review screens themes, but it does not guarantee that a theme will stay secure or work with every site setup. Also check the provider’s information about updates and compatibility.

Choose an installation method

When the dashboard supports your theme package, open Appearance → Themes → Add New. Search for a directory theme and select Install, or select Upload Theme on the same screen for a downloaded theme ZIP. WordPress documents both routes in its Themes screen instructions.

If the dashboard cannot upload the ZIP, ask your host what upload limit it has set. WordPress hosts do not all use the same limit. You can also use the host’s file manager to extract the theme into wp-content/themes/, or transfer the extracted theme folder there with FTP or SFTP. SFTP transfers files to a server securely. The host determines the exact path to the WordPress installation.

Developers and site administrators can install themes with WP-CLI, WordPress’s tool for running commands in a terminal. The wp theme install command accepts a theme slug, the path to a ZIP file on your computer, or a ZIP URL. Its --activate option activates the theme after installation. Check the current command documentation before using command options. Do not use --ignore-requirements as a routine workaround: it skips the theme’s stated WordPress and PHP requirements.

Check the theme package

WordPress recognizes a theme from the files and folders inside its theme folder. The theme’s style.css file must be directly inside that folder. If the extracted ZIP has an extra folder around the theme folder, move or upload the inner folder so WordPress can find the stylesheet. The theme stylesheet documentation explains how WordPress uses this file.

The files WordPress requires depend on the kind of theme. A basic classic theme needs style.css and index.php. A block theme needs style.css and templates/index.html. Block themes use HTML templates to lay out pages, while classic themes use PHP template files. WordPress explains these requirements in its guidance on classic theme files and theme structure.

A child theme is a separate theme that uses a parent theme’s features while keeping your custom code in its own files. Install the parent theme first. In the child theme’s style.css, the Template value must exactly match the parent theme’s folder name. The child theme handbook explains how child themes work and how to set them up.

Preview before activation

After installation, check that the theme appears under Appearance → Themes. Use Live Preview to see how it displays your existing content before activation. If the preview is blank or broken, check the theme package and follow the provider’s instructions before activating it. WordPress also recommends testing themes on a test site when practical in its theme instructions.

Activating a theme can change colors, typography, menu locations, widget areas, and page layouts. Some sites also rely on features that come with a specific theme. Installing a theme does not automatically import demo content. Follow the provider’s instructions to import demo content separately.

Check the site after activation

After you activate the theme, check a sample of pages on desktop and mobile. Review the header, footer, navigation, and page layouts, then test forms and other important site features. Compare key pages with the preview and make sure the content still appears in the right places.

Widgets or menus might move when you switch themes because the new theme has different areas for them. Check Appearance → Widgets and review any inactive widgets. WordPress can keep widget settings even when the active theme no longer displays the areas that used them. The widget management documentation explains how to find and manage widgets.

On a WordPress Multisite network, enabling a theme for the network makes it available to individual sites, but does not activate it on every site. The network administrator controls which themes are available. Each site’s administrator selects an active theme based on the network’s settings. See the documentation on Multisite administration.

Troubleshoot installation failures safely

If WordPress does not list the theme, check that you uploaded or extracted the right folder and that the required files are directly inside it. If the dashboard says it cannot write files, ask your host or server administrator to check who owns the files and what permissions they have. WordPress warns that incorrect permission changes can take a site offline. Do not make theme folders writable by everyone as a quick fix. Its file-permission guidance explains the risks.

If the theme installs but the preview fails, check the provider’s setup notes and support resources before activating it. If the site changes after activation, first check the menus, widget areas, and layouts that depend on the theme. WordPress’s theme troubleshooting guidance explains how switching themes can affect the site’s appearance and features.

Keep customizations separate

If you plan to customize a theme’s code, avoid editing its original files. An update to the parent theme can overwrite your changes. Put custom code in a child theme so you can update the parent without losing your work. For extensive changes, decide whether a child theme is still manageable or whether maintaining a separate theme is a better choice.

What I'm building

Delegate tasks. Get software.

Give Vroni a GitHub issue, bug report, spec, or rough idea. It reads the repo, plans the change, writes code, runs checks, and works toward a review-ready pull request.

Take a look at vroni.com