How to install a WordPress theme

Quick answer: install a WordPress theme from the dashboard (search or ZIP upload), by placing the theme folder into wp-content/themes via SFTP/host File Manager, or with WP‑CLI; choose the method that fits your access level and server constraints.

Prerequisites before installing

You need an Administrator account in WordPress to install and activate themes from the dashboard. Before any change, make a full backup of files and the database. This guide explains installation methods but does not replace professional support for complex sites.

Check the theme’s requirements in its README or vendor documentation and verify your current WordPress version. Some themes list minimum PHP or WordPress versions; confirm those requirements on the theme page before proceeding (do not assume compatibility).

If you expect to upload a large ZIP file via the dashboard, verify your host’s upload limits first. If the dashboard upload fails due to limits, use SFTP or the host File Manager instead. Where the documentation refers to upload limits or other server settings, verify values on your host documentation on the day you act.

Method 1 — Install from the WordPress Dashboard (Theme Directory and ZIP)

From the admin menu go to Appearance → Themes → Add New. Use the search box to find themes in the WordPress Theme Directory and click Install to add a directory theme, or click Upload Theme to submit a theme ZIP file from your device. The dashboard flow and upload buttons are described in the WordPress Theme documentation (work-with-themes) and the Learn.WordPress tutorial consulted September 27, 2026.

Before activating, use Live Preview or the Customizer to preview the theme on your site without changing the active theme. Previewing reduces surprises when theme templates and widget areas differ.

If the upload fails with an error, common causes are server upload limits or file permission restrictions. In those cases either upload the extracted theme folder via SFTP/host File Manager or follow the host’s guidance to resolve permissions; the Uploading WordPress docs explain the file-placement approach (codex uploading docs, September 27, 2026).

If the theme comes from a third‑party marketplace, verify the package contents and licensing included in the ZIP before installing. Vendor instructions in the theme package often include steps for bundled plugins or importers; follow the vendor docs for those tasks.

Method 2 — Upload via SFTP / FTP or host File Manager

If you have SSH/SFTP or host File Manager access, place the theme folder into wp-content/themes so WordPress recognizes it. Upload the entire theme directory (not just selected files) into wp-content/themes; this placement is the method described in the WordPress uploading documentation consulted September 27, 2026.

Prefer secure transfer methods such as SFTP/SSH over plain FTP when available. Many hosts restrict direct write access to web files; using SFTP or the host File Manager avoids dashboard upload limits and permission prompts.

If you upload a ZIP via the host File Manager, extract it into wp-content/themes so the folder structure matches what WordPress expects. After upload and extraction, activate the theme from Appearance → Themes in the dashboard.

File ownership or permissions can block dashboard installs. Server permissions may require adjustment by your host or sysadmin; this page avoids prescribing specific numeric permission values and directs you to the host support or documentation for corrective steps (see the Uploading WordPress and UNIX Shell Skills docs, consulted September 27, 2026).

Method 3 — WP‑CLI (command-line)

On servers where you have SSH access and WP‑CLI installed, you can install and activate themes from the command line. The canonical command is:

wp theme install <slug|path/to/theme.zip> --activate — WP‑CLI docs, consulted September 27, 2026.

WP‑CLI is useful for automation, scripted deployments, or headless workflows. It requires SSH access and appropriate user permissions on the server. Use WP‑CLI when you manage multiple sites or when dashboard access is not convenient.

Child themes and preserving customizations

A child theme keeps your custom CSS and template overrides separate from the parent theme, so parent updates do not overwrite customizations. The Theme Handbook explains creating a child theme and how to enqueue the parent stylesheet (developer.wordpress.org, child-themes, consulted September 27, 2026).

At minimum, a child theme needs its own folder and a style.css with a proper header; the handbook shows the exact header format to use. Some modern themes provide recommended child-theme scaffolding or specific instructions—follow the parent theme docs when available.

If you plan significant customizations, prefer a child theme rather than editing parent files directly. Where a theme provides a recommended method for custom CSS (customizer or a built-in custom CSS panel), follow that guidance to simplify updates.

Common problems and safe fixes

Upload failed: dashboard uploads can fail because of PHP upload_max_filesize or post_max_size restrictions. If upload limits block installation, switch to SFTP or the host File Manager. Verify limits in your host documentation rather than assuming defaults.

White screen or fatal error after activation: fatal PHP errors commonly occur when a theme requires plugins or a PHP version not present on the server. Check error logs or enable WordPress debug mode to see the error source. If you cannot access the dashboard, rename the active theme folder via SFTP to force WordPress to fall back to a default theme—see the WordPress debugging documentation for safe steps.

Missing demo content or imported layouts: many premium themes include demo importers or bundled plugins. Follow the theme vendor’s importer instructions. The Theme Handbook and vendor docs should be your reference points for demo content importers.

Widgets and menu locations changed: themes define their own widget areas and menu locations. Expect to reassign menus and widgets after switching themes; this is normal because theme support areas differ.

Special cases

Multisite networks: network administrators can enable themes network‑wide or allow per‑site activation. Some themes require network activation; consult the WordPress multisite docs and the theme’s documentation for recommended steps before activating across a network.

Premium themes and marketplaces: for premium ZIPs follow the vendor install instructions and check for bundled plugin dependencies. Verify licensing and included update mechanisms as described in the theme package.

Theme frameworks or child theme generators: some frameworks recommend specific child-theme structures or provide generators. If the parent theme documents a generator, follow those vendor instructions rather than a generic approach.

After-install checklist

Preview the site on a staging environment if possible. Check homepage layout, menus, widgets, and mobile layout. Confirm that required plugins for the theme are installed and activated, and that theme updates and plugin updates are visible in the Updates screen.

If the theme includes export/import tools for customizer settings or styles, export current settings before switching themes so you can restore them later if needed. Keep a fresh backup after a successful switch.

When to ask for professional help

Contact a developer or hosting support when you encounter PHP fatal errors you cannot diagnose, when admin access is lost, or when you need custom theme changes beyond CSS. For permission or ownership fixes on the server, host support or a sysadmin should make changes rather than guessing numeric permission values.

What we do not know

Related guides

Related guides

• How to choose a WordPress theme
• WordPress theme licenses and the GPL explained
• Free vs Premium WordPress Themes: Quick Comparison
• WordPress Themes