Sign up ×
WordPress Development Stack Exchange is a question and answer site for WordPress developers and administrators. It's 100% free, no registration required.

I'd like to use a custom post type archive as a site's front page, so that

is a custom post type archive displayed according to my archive-{post-type}.php file.

Ideally I would like to alter the query using is_front_page() in my functions.php file. I tried the following, with a page called "Home" as my front page:

 add_filter('pre_get_posts', 'my_get_posts');
 function my_get_posts($query){
     global $wp_the_query;
     return $query;

but the front page is returning the content of "Home" and seems to be ignoring the custom query.

What am I doing wrong? Is there a better way, in general, of going about this?

share|improve this question
is_front_page() will not work with pre_get_posts –  Brad Dalton Aug 18 '14 at 5:05

5 Answers 5

up vote 21 down vote accepted

After you have set a static page as your home page you can add this to your functions.php and you are good to go. This will call the archive-POSTTYPE.php template correctly as well.

add_action("pre_get_posts", "custom_front_page");
function custom_front_page($wp_query){
    //Ensure this filter isn't applied to the admin area
    if(is_admin()) {

    if($wp_query->get('page_id') == get_option('page_on_front')):

        $wp_query->set('post_type', 'CUSTOM POST TYPE NAME HERE');
        $wp_query->set('page_id', ''); //Empty

        //Set properties that describe the page to reflect that
        //we aren't really displaying a static page
        $wp_query->is_page = 0;
        $wp_query->is_singular = 0;
        $wp_query->is_post_type_archive = 1;
        $wp_query->is_archive = 1;


share|improve this answer
You nailed it, dude! Terima kasih banyak! –  Isaac Lubow Oct 12 '11 at 3:09
This function needs if(is_admin()) return; at the very beginning, otherwise it messes with the admin area. –  brasofilo Sep 11 '13 at 0:01
Thanks a lot! It works like a charm :) –  gosukiwi Jul 9 '14 at 18:45
While this worked for me, my primary and secondary menus disappeared as result. –  super9 Apr 19 at 17:44
It's almost correctly. This code is changing all wp_queries, so it should be if ( is_home() ) instead of if ($wp_query->get.....) –  Leo Caseiro Jun 10 at 4:59

Re-name your CPT archive to home.php

Then use pre_get_posts to alter the home page query so only CPT's display

function wpsites_home_page_cpt_filter($query) {
if ( !is_admin() && $query->is_main_query() && is_home() ) {
$query->set('post_type', array( 'your-cpt' ) );


Replace your-cpt with the name of your custom post type.

share|improve this answer
finally, a clear, workable explanation! –  Jack Jun 13 at 15:56

Thanks for the answer ljaas—I was looking to solve this exact problem. In order to get the custom post type archive template to be called I had to add the following conditions:

$wp_query->is_post_type_archive = 1;
$wp_query->is_archive = 1;
share|improve this answer
Hi Eli, welcome to WPSE. "Answers" are meant to answer the initial question (stackexchange sites are not threaded discussion forums). This would be a much better fit for a comment. –  Johannes Pille Jul 18 '13 at 23:31
Thanks for the clarification Johannes. That is what I thought, though I could not figure out how to comment on the answer as there is no 'add comment' feature available. Is this a time-sensitive feature, or am I blind? –  Eli Jul 20 '13 at 20:09

This works better for me overriding both blog posts and static page in Settings > Reading > Front page displays:

 * Set custom post type archive as front page.
 * @since 1.0.0
function ql_set_as_front_page( $query ) {
    if ( is_admin() || ! $query->is_main_query() ) {
    if ( ql_is_front_page( $query ) ) {
        $query->set( 'page_id', '' );
        $query->is_page = false;
        $query->is_singular = false;
        $query->set( 'post_type', 'MYCPT' );
        $query->is_archive = true;
        $query->is_post_type_archive = true;
add_action( 'pre_get_posts', 'ql_set_as_front_page' );

 * Taken from WP_Query::is_front_page and adapted to compare page_on_front with current page ID.
 * @since 1.0.0
 * @param object $query The main WP Query.
function ql_is_front_page( $query ) {
    if ( 'posts' == get_option( 'show_on_front') && $query->is_home() )
        return true;
    elseif ( 'page' == get_option( 'show_on_front') && get_option( 'page_on_front' ) && $query->get('page_id') == get_option( 'page_on_front' ) )
        return true;
        return false;

I'm using it in conjunction with a template override using the filters front_page_template and home_template to return a custom template.

share|improve this answer

For me it breaks the pagination : either you select the index or a static page as the home page, the pagination links shows up but when clicking on page 2 I get :

  • in case of index page (default) : the 404 page
  • in case of static page : the same results as page 1 : the "paged" argument is then interpreted to show the page type pagination, not the post type list pagination.

I think it needs some rewrite rules to catch the paged argument and pass it correctly.

Anyway, a custom template page should be the solution with some additional rewrite rules.

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.