Title: WP_Query::is_front_page
Published: April 25, 2014
Last modified: May 20, 2026

---

# WP_Query::is_front_page(): bool

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#description)
 * [Return](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#wp--skip-link--target)

Determines whether the query is for the front page of the site.

## 󠀁[Description](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#description)󠁿

This is for what is displayed at your site’s main URL.

Depends on the site’s “Front page displays” Reading Settings ‘show_on_front’ and‘
page_on_front’.

If you set a static page for the front page of your site, this function will return
true when viewing that page.

Otherwise the same as [WP_Query::is_home()](https://developer.wordpress.org/reference/classes/WP_Query/is_home/).

## 󠀁[Return](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#return)󠁿

 bool Whether the query is for the front page of the site.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#source)󠁿

    ```php
    public function is_front_page() {
    	// Most likely case.
    	if ( 'posts' === get_option( 'show_on_front' ) && $this->is_home() ) {
    		return true;
    	} elseif ( 'page' === get_option( 'show_on_front' ) && get_option( 'page_on_front' )
    		&& $this->is_page( get_option( 'page_on_front' ) )
    	) {
    		return true;
    	} else {
    		return false;
    	}
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-query.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/class-wp-query.php#L4472)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/class-wp-query.php#L4472-L4483)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_Query::is_home()](https://developer.wordpress.org/reference/classes/wp_query/is_home/)`wp-includes/class-wp-query.php` |

Determines whether the query is for the blog homepage.

  | 
| [WP_Query::is_page()](https://developer.wordpress.org/reference/classes/wp_query/is_page/)`wp-includes/class-wp-query.php` |

Determines whether the query is for an existing single page.

  | 
| [get_option()](https://developer.wordpress.org/reference/functions/get_option/)`wp-includes/option.php` |

Retrieves an option value based on an option name.

  |

[Show 1 more](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#)

| Used by | Description | 
| [is_front_page()](https://developer.wordpress.org/reference/functions/is_front_page/)`wp-includes/query.php` |

Determines whether the query is for the front page of the site.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/WP_Query/is_front_page/?output_format=md#changelog)󠁿

| Version | Description | 
| [3.1.0](https://developer.wordpress.org/reference/since/3.1.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_query%2Fis_front_page%2F)
before being able to contribute a note or feedback.