wp_title( string $sep = '»', bool $display = true, string $seplocation = '' ): string|null

User Contributed Notes

1. Skip to note 13 content

   Fahid Javid 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 21You must log in to vote on the helpfulness of this note

   Following is the recommended way instead of wp_title() function.

   /*
    * Let WordPress manage the document title.
    * By adding theme support, we declare that this theme does not use a
    * hard-coded <title> tag in the document head, and expect WordPress to
    * provide it for us.
    */
   add_theme_support( 'title-tag' );

   It should be placed in the functions.php file with after_setup_theme action hook.
2. Skip to note 14 content

   Dave Clements 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 12You must log in to vote on the helpfulness of this note

   wp_title() was originally to be deprecated in 4.4, but was reinstated while efforts were made to identify the unintended ways in which the function was being used to ensure that the deprecation wouldn’t break them. With the likelihood that wp_title() will be deprecated in the near future, it is recommended that you instead use its replacement: the title-tag theme feature.
3. Skip to note 15 content

   Codex 11 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   Zero-character sep
   The sep string may be zero characters, which will remove » from the returned value. To do this, set the sep parameter to zero characters, for example:

   <title><?php wp_title(''); ?></title>

   If the title of the post is “Hello world!”, then the function will return:

   Hello world!
4. Skip to note 16 content

   Codex 11 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Customizing with the filter
   If you want to change the way that the title displays on different pages you can use a filter.

   /**
    * Filters wp_title to print a neat <title> tag based on what is being viewed.
    *
    * @param string $title Default title text for current view.
    * @param string $sep   Optional separator.
    * @return string The filtered title.
    */
   function wpdocs_theme_name_wp_title( $title, $sep ) {
   	if ( is_feed() ) {
   		return $title;
   	}
   	
   	global $page, $paged;
   
   	// Add the blog name
   	$title .= get_bloginfo( 'name', 'display' );
   
   	// Add the blog description for the home/front page.
   	$site_description = get_bloginfo( 'description', 'display' );
   	if ( $site_description && ( is_home() || is_front_page() ) ) {
   		$title .= " $sep $site_description";
   	}
   
   	// Add a page number if necessary:
   	if ( ( $paged >= 2 || $page >= 2 ) && ! is_404() ) {
   		$title .= " $sep " . sprintf( __( 'Page %s', '_s' ), max( $paged, $page ) );
   	}
   	return $title;
   }
   add_filter( 'wp_title', 'wpdocs_theme_name_wp_title', 10, 2 );
5. Skip to note 17 content

   Codex 11 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Covering Homepage
   If you are using a custom homepage with custom loops and stuff or a custom front-page, you will have an empty wp_title. Here goes a neat hack to add the description/tagline at the wp_title place on homepage:

   <title><?php wp_title(''); ?></title>

   Then in your functions.php file in your theme:

   add_filter( 'wp_title', 'wpdocs_hack_wp_title_for_home' );
   
   /**
    * Customize the title for the home page, if one is not set.
    *
    * @param string $title The original title.
    * @return string The title to use.
    */
   function wpdocs_hack_wp_title_for_home( $title )
   {
     if ( empty( $title ) && ( is_home() || is_front_page() ) ) {
       $title = __( 'Home', 'textdomain' ) . ' | ' . get_bloginfo( 'description' );
     }
     return $title;
   }

   You can format this string as you want of course.
6. Skip to note 18 content

   Codex 11 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Default
   If you do not pass any parameters for a single post, for example:

   <title><?php wp_title(); ?></title>

   If the title of the post is “Hello world!”, then the function will return

   » Hello world!
7. Skip to note 19 content

   johnmichaelgrey 11 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Just wanted to check line 833 for mis-spelling:

   $t_sep = ‘%WP_TITILE_SEP%’; // Temporary separator, for accurate flipping, if necessary

   Is WP_TITILE_SEP spelled correctly? I might have thought it to be WP_TITLE_SEP

   I noticed this in my WP php file, and then again here.
8. Skip to note 20 content

   regijorge 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Display blog title after page/post title:

   <title><?php wp_title(''); echo ' | ';  bloginfo( 'name' ); ?></title>
9. Skip to note 21 content

   Marília Gonçalves Tavares 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   To solve the Homepage empty title tag I’m using this code below, on header.php template:

   <title>
   		<?php if(is_front_page() || is_home()){
   			echo get_bloginfo('name');
   		} else{
   			echo wp_title('');
   		}?>
   	</title>
10. Skip to note 22 content

    mymonoo 8 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    For setting POST_NAME | BLOG_NAME, this one line code should be great

    <?php wp_title('|',true,'right'); ?> <?php bloginfo('name'); ?> 
11. Skip to note 23 content

    seramo 5 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    To solve the Homepage empty title tag using this code on header.php :

    <?php echo is_front_page() ? get_bloginfo( 'name' ) : wp_title( '' ); ?>
12. Skip to note 24 content

    rayyanekaputra 10 months ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    But as 2025, this function left behind already. We use this in functions.php:
    add_theme_support( ‘title-tag’ );