document_title │ filter-hook │ WP 5.8.0

Allows you to change the page's <title>.

This hook changes the fully generated title — the final string. In contrast, the similar document_title_parts hook allows individual title parts to be changed.

Usage

add_filter( 'document_title', 'wp_kama_document_title_filter' );

/**
 * Function for `document_title` filter-hook.
 * 
 * @param string $title Document title.
 *
 * @return string
 */
function wp_kama_document_title_filter( $title ){

	// filter...
	return $title;
}

$title(string)

The page title.

Examples

#1 Change the front page title

For the site's front page, WordPress generates site title + description in the title by default, as specified on the “Settings -> General” page. For example:

My Test Site — Just another WordPress site

Change the title of the front page only:

add_filter( 'document_title', 'modify_document_title_for_front_page' );

/**
 * Changes the title of the site's front page.
 *
 * @param string $title
 *
 * @return string
 */
function modify_document_title_for_front_page( $title ) {
	return is_front_page() ? 'This title is only for the front page' : $title;
}