Troubleshooting
WordPress Theme Homepage Not Showing: Causes and How to Fix It

Short answer
A theme homepage usually fails to show because WordPress is still set to display your latest posts, the theme demo was never imported, an empty or draft page is assigned, or caching serves an old copy. Start by setting a static homepage under Settings, then Reading.
Key takeaways
- Installing a theme does not change your homepage setting or add demo pages.
- Set a static homepage under Settings > Reading.
- Theme demos need a separate import, often through a companion plugin.
- Block themes may use a Front Page template that overrides your page.
- A stray index.html in the root can load before WordPress.
Why is my WordPress theme homepage not showing?
A theme's homepage usually fails to show because WordPress is still set to display your latest posts, the demo content was never imported, the wrong page is assigned as the homepage, or a cache is serving an old version.
Most themes in demos show a designed homepage with sections, sliders and calls to action. After you install the theme, you often see a plain list of posts instead.
That is normal. Installing a theme does not create pages or change your homepage setting. It only changes how existing content looks.
| What you see | Likely cause | Fix |
|---|---|---|
| A list of blog posts | Homepage set to latest posts | Set a static homepage in Reading settings |
| A blank page with a title | Empty page chosen as homepage | Add content or import the demo |
| Theme demo looks different | Demo content and plugins missing | Import the demo with the theme's tool |
| Old homepage still shows | Caching | Purge all caches |
| Default server page or index.html | Extra index file in the root | Remove or rename index.html |
| Coming soon page | Maintenance mode is on | Turn off the coming soon setting |
Is WordPress set to show your latest posts?
Yes, this is the most common cause; go to Settings > Reading and set Your homepage displays to A static page, then choose the page you want as the homepage.
By default, WordPress shows your newest posts on the front page. Themes with a designed homepage expect a static page instead.
To change it:
- Create a page called Home, or use the one the theme demo created.
- Create a second page called Blog if you want a posts page.
- Open Settings > Reading.
- Choose A static page.
- Pick Home as the homepage and Blog as the posts page.
- Save changes and view the site.
The Reading Settings documentation explains each option. Our guide on how to set the homepage in WordPress walks through it with screenshots.
If you manage sites from the command line, WP-CLI can check the same setting. The show_on_front option holds posts or page, and page_on_front holds the ID of the chosen homepage.
Do not pick the same page for both fields. That confuses WordPress and can show the wrong content.
Did you import the theme's demo content?
Theme demos are built from sample pages, widgets, menus and settings that are not installed with the theme, so you must import the demo to get the same homepage.
Most premium and many free themes include a one-click demo import tool. It is often a companion plugin or a screen under Appearance.
The import usually:
- Creates sample pages, including a homepage
- Sets the homepage in Reading settings
- Adds menus and widgets
- Installs required plugins, such as a page builder
Check the theme's documentation for the exact steps. Some themes ask you to install a companion plugin before the import option appears.
Import demos on a new or staging site when possible. Demo imports can add many pages and images to a live site.
Is the chosen homepage page empty?
If you set a static homepage but see only a title or a blank area, the page you selected has no content or uses a template that expects a page builder layout.
Open the page in the editor. If it is empty, add blocks, insert a pattern, or rebuild it with your page builder.
Also check the page status. A page in draft, pending or private status will not show to visitors, even if it is set as the homepage.
Some themes need a specific page template for the homepage, such as Front Page or Full Width. Look in the page settings sidebar under Template.
Is a block theme using a different front page template?
Block themes control the homepage through templates in the Site Editor, so the Front Page or Blog Home template may show something different from the page you edited.
In block themes, open Appearance > Editor and look at Templates. The Site Editor documentation explains how templates work.
WordPress picks a template in a set order. A Front Page template overrides your chosen homepage design, while Blog Home controls the latest posts view.
Edit the template that is actually used, or reset it to the theme's default if a past edit broke it. Our explainer on block themes versus classic themes explains these differences.
Is a classic theme template overriding the homepage?
In classic themes, a front-page.php or home.php file decides what the homepage shows, and it can ignore page content if the theme was built to output fixed sections.
WordPress follows the template hierarchy to choose a file for each view. front-page.php takes priority for the site's front page.
Some themes build their homepage from Customizer settings rather than page content. In that case, open Appearance > Customize and look for a homepage or front page section.
If the theme has a child theme, check whether the child includes its own front-page.php. A file there can override the parent design.
Is caching showing an old homepage?
If you changed the homepage but still see the old one, a page cache, server cache or CDN is serving a stored copy, so purge every cache layer and check in a private window.
Caching plugins store the homepage as a static file for speed. Changing Reading settings does not always clear it.
Clear the plugin cache, the host's server cache and any CDN. Then reload in a private tab.
Our guide on how to clear cache in WordPress covers the common plugins and hosts.
Is an index.html file blocking WordPress?
If your domain shows a host welcome page or an old static site instead of WordPress, an index.html file in the root folder is loading before WordPress's index.php.
Servers usually look for index.html before index.php. Apache controls this with the DirectoryIndex setting.
Hosts often place a default index.html in new accounts. It stays there after you install WordPress.
Open the site's root folder with your file manager. If you see index.html next to wp-config.php, rename it to index-old.html and reload the site. Our guide on the WordPress root directory shows where to find that folder.
Is maintenance or coming soon mode on?
Some hosts, themes and plugins show a coming soon page to visitors while you build, so logged-in admins see the homepage and everyone else does not.
Check for a coming soon or maintenance plugin in your plugins list. Many hosts also have a toggle in their dashboard for new sites.
WordPress.com and some managed hosts launch sites in coming soon mode by default. Look for a launch or visibility setting.
Test in a private window to see what visitors see. If it differs from your logged-in view, a coming soon setting is the likely cause.
Could a plugin conflict hide the homepage?
Yes, a page builder that is missing or deactivated, or a plugin clash, can leave the homepage blank or show raw shortcodes instead of the designed sections.
If the homepage was built with Elementor, WPBakery or another builder, that plugin must stay active. Without it, the content breaks.
Reactivate required plugins listed by the theme. Then test for conflicts by disabling others one at a time.
Our guide on fixing a plugin conflict explains how to test safely.
If the homepage shows a completely white screen, see our guide to the white screen of death.
What should I check if nothing works?
Confirm the theme is active, the homepage page is published, Reading settings point to it, caches are cleared, and no extra index file exists, then switch to a default theme to isolate the issue.
A quick switch to a default theme on a staging copy tells you whether the problem lives in the theme or elsewhere.
If the default theme shows your chosen homepage correctly, contact the theme's support with the steps you tried. Theme authors know their homepage setup best.
Frequently asked questions
Why does my WordPress homepage show blog posts instead of my theme design?
WordPress shows your latest posts on the front page by default. Go to the Reading settings, choose a static page for the homepage, and select the page that holds your design, or import the theme demo to create one.
Why does my site not look like the theme demo?
The demo uses sample pages, menus, widgets, images and often a page builder that are not included when you install the theme. Use the theme's demo import tool, usually provided through a companion plugin, to copy that setup.
Can I have a homepage and a blog page at the same time?
Yes. Create two pages, such as Home and Blog, then in Reading settings choose Home as the homepage and Blog as the posts page. WordPress fills the Blog page with your latest posts automatically.
Why does my homepage show correctly when logged in but not to visitors?
Logged-in admins often bypass caches and coming soon pages. Visitors may see a cached copy or a maintenance screen. Purge every cache and turn off any coming soon mode, then check again in a private window.
Why is my homepage blank after changing themes?
The new theme may not support the layout built by your old theme or page builder, or the homepage relies on a plugin that is now inactive. Reactivate the builder, check the page template and rebuild sections if needed.
Sources
- Reading Settings Screen WordPress.org
- Site Editor WordPress.org
- Template Hierarchy WordPress Developer Resources
- mod_dir: DirectoryIndex Apache HTTP Server
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.


