is_front_page()

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

Contents

Description 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 @see is_home()

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Return Return

(bool) True, if front of site.

Top ↑

Source Source

File: wp-includes/query.php 

function is_front_page() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_front_page();
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.5.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/class-wp-query.php: WP_Query::is_front_page()

Is the query for the front page of the site?
wp-includes/functions.php: _doing_it_wrong()

Mark something as being incorrectly called.

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/general-template.php: wp_get_document_title()

Returns document title for the current page.
wp-includes/general-template.php: wp_title()

Display or retrieve page title for all areas of blog.
wp-includes/nav-menu-template.php: _wp_menu_item_classes_by_context()

Add the class property classes for the current context, if applicable.
wp-includes/post-template.php: wp_page_menu()

Displays or retrieves a list of pages with an optional home link.
wp-includes/post-template.php: get_body_class()

Retrieves an array of the class names for the body element.
wp-includes/canonical.php: redirect_canonical()

Redirects incoming links to the proper URL based on the site url.
Show 1 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Example for loading a different header on the front page:

    if ( is_front_page() ) :
	get_header( 'front' );
else :
	get_header();
endif;

You must log in before being able to contribute a note or feedback.