Creating a static front page in WordPress is one of the most fundamental customisations you can make to transform your site from a blog-style layout into a professional, purpose-built website. By default, WordPress displays your latest posts on the homepage, but switching to a static page gives you full control over what visitors see first. This guide walks you through every method available, from the WordPress dashboard to WP-CLI commands, so you can confidently set up your site exactly the way you want it.
Understanding the Difference Between a Static Front Page and a Blog Feed
Before diving into the steps, it helps to understand what a static front page actually means in WordPress terminology.
What Is a Static Front Page?
A static front page is a standard WordPress page (not a post) that is manually assigned to display as the homepage. Unlike the default blog feed, it does not automatically update with new content. You control exactly what appears — whether that is a landing page, a business homepage, or a portfolio showcase.
What Is the Posts Page?
When you set a static front page, WordPress also lets you designate a separate posts page — a dedicated archive page that automatically lists all your blog posts. This means you can have both a polished homepage and a fully functional blog running simultaneously.
Why Use a Static Front Page?
- Present a professional first impression with custom messaging and calls to action.
- Improve SEO by targeting specific keywords on your homepage.
- Give visitors a clear navigation path rather than dumping them into a blog feed.
- Integrate page builders like Elementor or Gutenberg for rich visual layouts.
Step 1 — Create the Pages You Need
Before you can assign a static front page, you need at least one published WordPress page to use as the homepage. If you also want a blog, you will need a second page for your posts feed.
Creating a Home Page
- Log in to your WordPress admin dashboard.
- In the left-hand menu, navigate to Pages > Add New.
- Give the page a clear title such as Home or Welcome.
- Add your desired content using the Gutenberg block editor or your preferred page builder.
- Click Publish to make the page live.
Creating a Blog Page (Optional but Recommended)
- Go to Pages > Add New again.
- Title this page Blog, News, or whatever suits your site.
- Leave the page body content blank — WordPress will automatically populate it with your posts.
- Click Publish.
Important: Do not add any content to the blog page. WordPress overwrites the page content when it renders the posts archive, so any content you add there will never be shown.
Step 2 — Configure Reading Settings in the WordPress Dashboard
With your pages published, you are ready to assign them using the WordPress Reading Settings panel.
Navigating to Reading Settings
- From the admin menu, go to Settings > Reading.
- At the top of the page you will see the option labelled Your homepage displays.
- By default, Your latest posts is selected. Click the radio button next to A static page (select below).
Assigning the Front Page and Posts Page
- Under the Homepage dropdown, select the page you created and titled Home.
- Under the Posts page dropdown, select the page you titled Blog (or leave it set to none if you do not want a blog feed).
- Scroll down and click Save Changes.
Visit your site URL. You should now see your custom static page displayed as the homepage instead of the latest posts feed.
Verifying the Change
After saving, WordPress automatically assigns the page_on_front and page_for_posts options in the database. You can confirm everything is working by visiting your homepage URL and checking that the blog page URL (e.g. yoursite.com/blog) correctly lists your posts.
Step 3 — Set a Static Front Page Using WP-CLI
If you manage WordPress from the command line — common in staging environments, managed hosting, or automated deployments — WP-CLI gives you a fast, scriptable way to configure the front page without touching the dashboard.
Prerequisites
Make sure WP-CLI is installed on your server and that you can run it from the WordPress root directory. You will also need the page IDs for your home page and blog page. Retrieve them with:
wp post list --post_type=page --fields=ID,post_title,post_statusThis command outputs a table of all pages with their IDs. Note the IDs for your Home and Blog pages.
Applying the Settings via WP-CLI
Replace 2 and 5 with your actual page IDs:
# Set the front page display to a static page
wp option update show_on_front page
# Assign the Home page (ID 2) as the static front page
wp option update page_on_front 2
# Assign the Blog page (ID 5) as the posts page
wp option update page_for_posts 5After running these commands, verify the change:
wp option get show_on_front
wp option get page_on_front
wp option get page_for_postsEach command should return the values you just set, confirming successful configuration.
Step 4 — Setting the Front Page Programmatically with PHP
For theme developers or plugin authors who need to set a static front page during theme activation or plugin installation, PHP is the appropriate approach. The following snippet demonstrates how to update the necessary WordPress options programmatically.
Using update_option() in functions.php or a Plugin
<?php
/**
* Set a static front page on theme activation.
* Place this inside a theme activation hook or plugin activation hook.
*/
function my_theme_set_static_front_page() {
// Check if pages already exist before creating them
$home_page = get_page_by_path( 'home' );
$blog_page = get_page_by_path( 'blog' );
// Create Home page if it does not exist
if ( ! $home_page ) {
$home_id = wp_insert_post( array(
'post_title' => 'Home',
'post_name' => 'home',
'post_status' => 'publish',
'post_type' => 'page',
'post_content' => '<!-- wp:paragraph --><p>Welcome to our website.</p><!-- /wp:paragraph -->',
) );
} else {
$home_id = $home_page->ID;
}
// Create Blog page if it does not exist
if ( ! $blog_page ) {
$blog_id = wp_insert_post( array(
'post_title' => 'Blog',
'post_name' => 'blog',
'post_status' => 'publish',
'post_type' => 'page',
) );
} else {
$blog_id = $blog_page->ID;
}
// Update Reading Settings
update_option( 'show_on_front', 'page' );
update_option( 'page_on_front', $home_id );
update_option( 'page_for_posts', $blog_id );
}
add_action( 'after_switch_theme', 'my_theme_set_static_front_page' );
?>This code hook fires whenever the theme is activated, automatically creating and assigning pages if they do not already exist. It is ideal for theme frameworks or client starter themes where you want a consistent default setup.
Troubleshooting Common Static Front Page Issues
Even after following every step correctly, you may encounter unexpected behaviour. Here are the most common problems and how to resolve them.
Homepage Still Showing Latest Posts
If your homepage still displays the blog feed after saving changes, try the following:
- Clear any caching plugin (W3 Total Cache, WP Super Cache, LiteSpeed Cache) and refresh.
- Confirm the page you assigned is set to Published status — draft pages cannot be used as the front page.
- Check that no other plugin is overriding the
show_on_frontorpage_on_frontoptions.
Blog Page Shows a Blank Page or Custom Content Instead of Posts
This almost always happens because content was added to the page body of the posts page. Edit the page and remove all content from the editor, then update. WordPress replaces the page body with the posts loop automatically.
Custom Page Template Not Applying to Front Page
Some page builders and custom templates use conditional checks. Ensure your template uses is_front_page() rather than is_home() for targeting the static homepage. In WordPress terminology:
is_front_page()returnstruewhen visiting the site root, regardless of whether it is a static page or the latest posts.is_home()returnstruefor the posts index — which is the blog page when a static front page is set.
Permalinks Returning 404 After the Change
After reassigning pages, visit Settings > Permalinks and click Save Changes (no need to change anything) to flush and regenerate the rewrite rules. This resolves the majority of 404 errors that appear after structural site changes.
Frequently Asked Questions
Can I use a page built with Elementor or Divi as my static front page?
Yes, absolutely. Build your page with any page builder, publish it, and then assign it under Settings > Reading as your front page. The static front page setting works independently of how the page content was created.
Will setting a static front page affect my SEO?
It can actually improve your SEO. A static front page lets you target specific keywords, add structured content, and control your homepage title and meta description more precisely than a generic blog feed. Ensure your SEO plugin (such as Yoast or Rank Math) is configured to set a custom title and description for the static homepage.
What happens to my existing posts when I set a static front page?
Your posts are not deleted or hidden. They remain published and accessible via their individual URLs, categories, tags, and the designated posts page. Only the homepage changes — posts no longer appear there by default.
Can I revert back to showing latest posts on the homepage?
Yes, at any time. Go to Settings > Reading, select "Your latest posts" and save. Your homepage will immediately revert to the blog feed, and the pages you created remain published and accessible at their own URLs.
Setting up a static front page in WordPress is a straightforward process once you understand the three core steps: create your pages, assign them in Reading Settings, and optionally automate the process with WP-CLI or PHP. Whether you manage a single site or dozens of client installs, these techniques give you reliable, repeatable control over your homepage configuration. If you would prefer to skip the manual steps entirely, WP AI Agent is a powerful tool that lets you handle WordPress tasks like this — including setting your static front page, creating pages, and updating settings — simply by describing what you want in natural-language AI chat, making site management faster and more accessible than ever.