← All posts

How to Install a WordPress Theme ZIP and Set Up a Child Theme

WordPress GPL · November 9, 2026

A premium WordPress theme arrives as a ZIP, often wrapped inside a bigger package with documentation and extras. Installing it takes a minute once you know which file to upload. Deciding whether you need a child theme, and setting one up before you start customising, can save hours later. This guide covers both.

Check what you downloaded

Open the download without extracting it and look at the top level:

  • One folder containing style.css and the theme's template files. That is an installable theme ZIP; upload it as it is.
  • Several ZIPs, a documentation folder or licence files. That is the developer's full package. Extract the outer archive; the theme itself is normally the ZIP that carries the theme's name. A second ZIP with “child” in its name is a ready-made child theme; keep it for later.
  • A “Pro” product that is really a plugin. Some popular themes are free in the WordPress theme directory and sell their extra features as a plugin. Astra Pro is one example: install the free Astra theme from the directory, then upload Astra Pro on the Plugins screen as described in our plugin installation guide.

Install a theme from the dashboard

  1. Go to Appearance → Themes and click Add New Theme (Add New in older versions).
  2. Click Upload Theme, then Choose File, and select the theme ZIP.
  3. Click Install Now.
  4. Click Live Preview to try it without changing your live site, or Activate to switch over.

If you plan to use a child theme, install the parent now but don't customise anything yet. Read the child theme section below first.

Install over SFTP or a file manager

Use this route when the upload fails because of size limits, which large themes with bundled plugins can exceed. Extract the theme ZIP and upload the folder to wp-content/themes, so that the stylesheet ends up at wp-content/themes/theme-name/style.css. Then activate the theme under Appearance → Themes. With SSH access, wp theme install ./theme-name.zip --activate does the same in one step.

After activating: plugins, demo content and basics

  • Required plugins. Many premium themes rely on a companion plugin or a page builder and show a notice listing what to install. Install the required ones from that notice. Some packages also include bundled plugins as ZIPs you can upload yourself if the notice asks for a theme licence first.
  • Demo content. Most themes offer a demo importer on their setup screen. Some importers fetch the demo content from the developer's own servers and won't proceed without a licence; if that happens, you can still build pages from the theme's own templates and blocks.
  • The basics. Set your homepage under Settings → Reading, assign menus (Appearance → Menus, or the Site Editor in block themes) and check the site on a phone.

Keep one of WordPress's default themes installed as well. It gives the site something to fall back on if your main theme ever fails to load.

Common theme installation errors

“The theme is missing the style.css stylesheet”

You uploaded the full package, or a plugin, instead of the theme ZIP. Extract the outer archive and upload the ZIP whose top folder contains style.css.

“The link you followed has expired”

The file is bigger than your server's upload limit. Raise the PHP upload limits or install over SFTP; the plugin guide linked above explains both fixes.

“The parent theme could not be found”

You uploaded a child theme before its parent, or the child's Template line doesn't match the parent's folder name. Install the parent first. Until then, Appearance → Themes lists the child under Broken Themes.

A blank screen or critical error after activation

Usually a PHP version below the theme's requirement or a missing companion plugin. Use the recovery-mode link WordPress emails to the site administrator, or rename the theme's folder over SFTP so it can't load, then sign in and activate a different theme.

A “destination folder already exists” message

Some WordPress versions refuse to overwrite an existing theme folder. Replace the folder over SFTP instead, after taking a backup.

Child themes: what they are and when you need one

A child theme is a small theme that inherits everything from a parent theme and holds only your changes. When the parent is updated its files are replaced, and anything edited inside them is lost; the child's files are left alone.

You need a child theme if you edit template files such as header.php, add PHP to functions.php, override WooCommerce templates inside the theme, or keep a large stylesheet you want under version control.

You can probably do without one if you only use the Customizer, the theme's options panel, a page builder or the Additional CSS box. Those settings are stored in the database rather than in theme files, so updating the parent leaves them alone.

One catch decides the timing. WordPress keeps Additional CSS, and most themes keep their Customizer settings, separately for each theme, and a child theme counts as a different theme. Switch from the parent to a child after customising the site and those settings stay behind; you would have to redo them, or export and import them if the theme supports that. So make the decision before you start customising.

Block themes work slightly differently. Changes made in the Site Editor are saved in the database, so theme updates don't overwrite them, but they are tied to the active theme too, so the same timing advice applies. You only need a child block theme if you edit the theme's files. The free Create Block Theme plugin from the WordPress directory can generate one for you.

How to set up a child theme

Option A: use the developer's child theme

If the package includes a child theme ZIP, use it. It is already set up to load the parent's styles in the way that theme expects.

  1. Install the parent theme. It must stay installed, but it doesn't need to be active.
  2. Upload the child theme ZIP the same way: Appearance → Themes → Add New Theme → Upload Theme.
  3. Activate the child theme, then customise.

Option B: create one yourself (classic themes)

  1. Create a folder in wp-content/themes, for example example-child.
  2. Inside it, create style.css starting with the header below. Template must be the parent's folder name exactly as it appears in wp-content/themes, not its display name.
    /*
    Theme Name: Example Child
    Template: example
    Version: 1.0.0
    */
  3. Create functions.php to load the parent's stylesheet and then the child's:
    <?php
    add_action( 'wp_enqueue_scripts', function () {
        wp_enqueue_style( 'parent-style', get_template_directory_uri() . '/style.css' );
        wp_enqueue_style( 'child-style', get_stylesheet_uri(), array( 'parent-style' ), wp_get_theme()->get( 'Version' ) );
    } );
  4. Activate Example Child under Appearance → Themes and check the site.

Some parent themes already load their stylesheet in a way that covers child themes. If the parent's styles load twice, or your child CSS doesn't take effect, check the theme's documentation. That is the main reason the developer's own child theme is the safer starting point.

Updating the parent theme later

With a child theme active, updating the parent is straightforward. Upload the newer parent ZIP through Upload Theme; WordPress recognises the installed theme, shows the current and uploaded versions side by side and offers to replace it (the button's wording varies between WordPress versions). The child theme and your changes stay exactly as they were. Our guide to updating GPL plugins and themes adds the backup and staging steps. Building with Elementor instead? Our guide to importing an Elementor template kit pairs well with a lightweight theme.

Product names belong to their owners. WordPress GPL is an independent store and is not affiliated with or endorsed by the developers mentioned here.

FAQ

Do I need a child theme for every site?

No. If all your changes go through the Customizer, theme options or a page builder, the parent theme alone is fine. Use a child theme when you edit theme files.

Why doesn't my site look like the theme demo?

The demo includes content, images, menus and plugin settings that a fresh install doesn't have. Run the theme's demo importer, or rebuild the pages you need from its templates.

Will switching themes delete my posts and pages?

No, your content stays in the database. Menus, widgets and Customizer settings may need reassigning, and layouts built with one theme's own shortcodes can lose their formatting.

Can I use one theme on several sites?

Yes. Themes in our theme catalogue, including the WooCommerce themes, are covered by the GPL, which sets no cap on how many sites you run them on, yours or your clients'. A membership gives you every theme, plugin and Elementor kit for as long as your plan runs.

Comments

Be the first to comment.

Leave a comment

Comments are moderated before they appear.