Troubleshooting
Why Is Your WordPress Theme Not Showing? Causes and Fixes

Short answer
A WordPress theme usually does not show because you uploaded the full download package instead of the installable zip, a child theme's parent is missing, or a cache still serves the old design. If the theme is active but looks plain, its demo content and settings were never imported.
Key takeaways
- Upload the inner installable theme zip, not the full marketplace download.
- A theme folder must have style.css at its top level to appear.
- Child themes need their parent theme installed to work.
- Clear plugin, server, CDN and browser caches after switching themes.
- Activating a theme does not import its demo content or settings.
Why is your WordPress theme not showing?
A WordPress theme usually fails to show because the uploaded zip is the wrong file, a child theme's parent is missing, a cache is serving the old design, or the theme needs demo content and settings that were never imported.
The fix depends on where the theme is missing. Use this table to find your situation:
| Symptom | Likely cause | First fix |
|---|---|---|
| Theme not listed in Appearance > Themes | Wrong zip, nested folder or missing style.css | Upload the installable theme zip |
| The parent theme is missing message | Child theme without its parent | Install the parent theme |
| Stylesheet is missing message | Theme files in the wrong folder | Move files up one level |
| Theme active but site looks the same | Cache or page builder overrides | Clear all caches |
| Theme active but looks nothing like the demo | Demo content and settings not imported | Run the theme's demo import |
| Site looks unstyled or broken | CSS not loading | Check HTTPS and optimization plugins |
| Theme missing on a multisite subsite | Theme not network enabled | Enable it in Network Admin |
Work through the sections below in order. Most problems are solved by the first two or three checks.
Did you upload the correct theme zip file?
Many theme downloads contain documentation, licenses and a second zip inside, so you must upload the inner installable theme zip, not the full download package.
Premium themes from marketplaces are a common case. The main download often holds a folder with docs, demo files, a child theme and the real theme zip. WordPress cannot install that bundle.
To fix it:
- Unzip the download on your computer.
- Look for a zip named after the theme, often in a folder called theme or installable.
- Go to Appearance > Themes > Add New Theme > Upload Theme.
- Upload that inner zip and click Install Now.
- Click Activate.
Our guide on installing a WordPress theme from a zip covers the upload steps in more detail.
Also make sure you uploaded a theme and not a plugin. Some products ship both. Plugins go under Plugins > Add New Plugin, not the themes screen.
Is the theme folder nested or missing style.css?
WordPress only lists a theme if its folder in wp-content/themes contains a style.css file with a theme header at the top level, so a folder inside another folder stays hidden.
Uploading by FTP often creates this problem. You end up with a path like wp-content/themes/mytheme/mytheme/style.css, and WordPress cannot find the theme.
Check over FTP or your host's file manager:
- Open wp-content/themes.
- Open the theme's folder.
- Confirm style.css and index.php, or a templates folder for block themes, sit directly inside it.
- If you see another folder with the same name, move its contents up one level.
The style.css header holds the theme name and details. If it is missing or damaged, the theme shows as broken under Appearance > Themes, often with a Stylesheet is missing message. The WordPress Theme Handbook explains the files every theme needs.
Is your child theme missing its parent theme?
Yes, if WordPress shows a message that the parent theme is missing, because a child theme cannot work unless its parent theme is installed in the same themes folder.
Child themes contain only your changes. They load everything else from the parent, which is named in the Template line of the child's style.css.
To fix it:
- Find the parent theme's name in the child's style.css.
- Install the parent theme, either from the directory or by uploading its zip.
- Do not activate the parent. Just make sure it is installed.
- Activate the child theme again.
The folder name of the parent must match the Template value exactly, including capital letters. Our explainer on what a child theme is covers how the two connect.
If the child is active but your styles do not apply, see our guide on child theme style.css not working.
Does your site meet the theme's requirements?
A theme may refuse to activate if your WordPress or PHP version is older than it needs, and WordPress shows a requirements message on the themes screen.
Themes can declare a minimum WordPress version and a minimum PHP version. WordPress checks these before activation and blocks themes your server cannot run.
To check:
- Look under Tools > Site Health > Info for your WordPress and PHP versions.
- Compare them with the theme's requirements on its page or in its documentation.
- Update WordPress from Dashboard > Updates.
- Ask your host to update PHP, or change it in the hosting panel.
Our guide on checking the PHP version on your host shows where to look in common hosting panels.
Block themes also need a WordPress version that supports full site editing. Very old WordPress installs cannot run them at all.
Is a cache showing the old design?
Very often, yes, because a cache plugin, server cache, CDN or your browser may keep serving pages built with the old theme after you switch.
When you are logged in, you may see the new theme while visitors still see the old one, or the reverse.
Clear every layer:
- Clear your cache plugin.
- Purge the server cache from your hosting panel if your host provides one.
- Purge your CDN, such as Cloudflare. Its purge cache guide shows the options.
- Hard refresh your browser, or open the site in a private window.
Our guide on clearing cache in WordPress covers each layer.
CSS optimization plugins can also keep combined stylesheets from the old theme. Clear their cache or regenerate the files after a theme switch.
Why does the theme not look like the demo?
The demo uses sample content, menus, widgets and settings that are not included when you activate a theme, so a fresh install looks plain until you import the demo or build those parts yourself.
This is the most common surprise with new themes. Activation only changes the design files. Your posts, pages, menus and homepage settings stay as they were.
To get closer to the demo:
- Look for a demo import or starter templates option in the theme's menu or a companion plugin.
- Install any required plugins the theme recommends, such as a page builder.
- Set a static homepage under Settings > Reading if the demo uses one.
- Assign menus to the theme's menu locations.
- Add the demo's widgets or template parts.
Import demos on a new site or staging copy where possible. Imports can add many pages, images and settings that are hard to undo on a live site.
Is a page builder or plugin overriding the theme?
Yes, it can be, because page builders, landing page plugins and coming soon plugins can replace the theme's output on some or all pages.
If certain pages ignore the new theme, check how they were built:
- Pages made with a builder's canvas or blank template skip the theme's header and footer.
- Theme builder features in some page builders replace headers, footers and templates site-wide.
- Maintenance or coming soon plugins show their own page to visitors.
Edit one affected page and check its template in the sidebar. Switch it to the default template to see the theme's layout. Our guide on changing a WordPress theme lists what to check before and after a switch.
Why does the theme look unstyled or broken?
The theme's CSS is not loading, usually because of mixed HTTP and HTTPS content, a wrong site address setting, or a script optimization plugin that broke the stylesheets.
An unstyled site shows plain text, blue links and stacked images. Open your browser's developer tools, check the Console and Network tabs, and look for failed CSS files.
Common causes:
- Mixed content. The site loads on https, but stylesheets load over http and the browser blocks them. MDN's guide to mixed content explains why. Make sure both addresses in Settings > General use https.
- Optimization plugins. Combine or minify CSS options can produce broken files. Turn them off to test.
- Wrong file permissions. The server cannot read the theme files. Folders usually need 755 and files 644.
- A failed update. A half-finished theme update can leave files missing. See our guide on fixing a theme that broke after an update.
If the whole site turns white instead, a PHP error is the cause. Turn on debug logging using the WordPress debugging guide, or follow our guide to the white screen of death.
Why is the theme missing on a multisite subsite?
On multisite, a theme only appears for subsites after the Super Admin enables it for the network or for that site.
Installed themes are not automatically available on every subsite. The Super Admin controls which themes each site can use.
To make a theme available:
- Go to My Sites > Network Admin > Themes.
- Click Network Enable under the theme to allow it on every site.
- Or go to Sites, edit one site, open its Themes tab, and enable the theme there.
Subsite admins can then activate it from their own Appearance > Themes screen. Our guide on enabling multisite explains the network admin area.
What should you do if nothing works?
Test with a default theme and no plugins using the Health Check plugin, then reinstall a fresh copy of your theme and contact its developer with the errors you found.
The free Health Check and Troubleshooting plugin lets you switch theme and plugins for your own session only. If your theme works there, a plugin conflict is the cause.
When you contact the theme's support, include your WordPress version, PHP version, any error messages, and the steps you already tried. Premium theme support usually needs your purchase code.
Frequently asked questions
Why does my theme not appear after uploading it?
You probably uploaded a bundle that holds docs and another zip inside, or the theme folder is nested inside a second folder. Unzip the download, find the installable theme zip, and upload that file under Appearance, Themes, Add New Theme.
Why does my new theme look different from the demo?
Activating a theme only changes the design files. The demo's pages, images, menus, widgets and homepage settings are not added. Use the theme's demo import tool or starter templates, ideally on a staging site, to copy the demo setup.
What does the parent theme is missing message mean?
You activated or uploaded a child theme without its parent theme. Install the parent theme named in the child's style.css file. You do not need to activate it, but it must be in the themes folder.
Why do visitors still see my old theme?
A page cache, server cache or CDN is still serving pages built with the old theme. Clear each cache layer and test in a private window. Logged-in admins often bypass the cache, which is why you may see the new theme first.
Can a plugin stop my theme from showing?
Yes. Page builders with theme builder features, maintenance mode plugins and landing page plugins can replace the theme's output. Test with plugins turned off for your session using Health Check to see if one of them is the cause.
Sources
- Theme Handbook WordPress Developer Resources
- Debugging in WordPress WordPress Developer Resources
- Health Check & Troubleshooting WordPress.org
- Mixed content MDN Web Docs
- Purge cache Cloudflare Docs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


