How to use the get_page_by_title() function in WordPress

Update: This function has been deprecated in WordPress 6.2. We’ve written an article about replacing get_page_by_title(). Read More.

The simplicity with which WordPress pages can be produced and administered is one of the platform’s defining characteristics. Pages are an excellent tool for organising the content on your website, and they provide a representation of your content that is both static and non-chronological.

A powerful function known as get_page_by_title() is made available to developers by WordPress. This function makes it simple to fetch a particular page depending on the title of that page. In this article, we’ll take a look at how to use this particular function in WordPress so that you can get the most out of it.

What does the get_page_by_title() function do?

You can receive a specific page by specifying its title when using the get_page_by_title() function, which is a built-in feature of WordPress. It requires two parameters, which are the page title and the type of output. The output type argument is responsible for determining the format of the data that is returned by the function. You can use the function to receive just the page ID, the page content, or the page title. By default, it returns the complete page object; however, you can alternatively use it to retrieve just that information.

Using_get_page_by_title ()

You will need to be familiar with the title of the page you need to access before you can use the get page by title() function. You will be able to utilise the function to fetch the page as soon as you have the title. This is just one illustration:

$page_title = 'About Us';
$page = get_page_by_title( $page_title );

In this specific instance, we are retrieving the page that bears the heading “About Us.” The get page by title() function gives back the complete page object, which contains the page ID as well as the page title, content, and any other data that was passed to it. This object will be saved in the $page variable so that we can retrieve it at a later time.

You are able to access any of the page object’s properties once you have the page object in your control. For instance, if you want to access the content of the page, you can use the code below:

$page_content = $page->post_content;

In order to obtain the page content, we are making use of the $page object in this demonstration. The content of the page can be found in the post content field of the post type.

Modifying the Output to Meet Your Needs

By giving in the output type option, you are able to tailor the results that are returned by the get_page_by_title() function, as was previously explained. This is just one illustration:

$page_title = 'About Us';
$page = get_page_by_title( $page_title, OBJECT, 'page' );

In this example, we are making use of the same title that we used in the previous example; but, in addition, we are sending in two extra arguments. The second parameter is the output type, and we’ve decided to use the value OBJECT for this. By passing this to the method, you are instructing it to return an object rather than an array.

The type of post becomes the third parameter. You can use this argument to search for additional post types in addition to pages when using the get_page_by_title() function, which searches for pages by default.


It is possible to access a specific page within WordPress by using the get_page_by_title() function, which is a powerful tool that can be found in WordPress. You may quickly and simply access the content of a page and use it wherever you like in your code if you make use of this method. get_page_by_title() is a very helpful tool to have in your arsenal of WordPress development tools, regardless of whether you’re developing a custom theme or a plugin.