get_page_by_title ( $page_title, $output = OBJECT, $post_type = 'page' )

  • (string) page_title Page title.
  • (string) output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Post object, an associative array, or a numeric array, respectively. Default OBJECT.
  • (string|array) post_type Optional. Post type or array of post types. Default 'page'.
  • (WP_Post|array|null) WP_Post (or array) on success, or null on failure.
Defined at:
Change Log:
  • 3: .


Retrieves a page given its title.If more than one post uses the same title, the post with the smallest ID will be returned. Be careful: in case of more than one post having the same title, it will check the oldest publication date, not the smallest ID. Because this function uses the MySQL '=' comparison, $page_title will usually be matched as case-insensitive with default collation.

Related Functions

get_page_by_path, get_admin_page_title, get_the_title, get_page_children, get_page_statuses

Top Google Results

User discussions

wpseek mobile