Function and usage of previous_posts() in wordpress


Answers ( 1 )


    The previous_posts() function in WordPress is used to display or retrieve the link for the previous posts page. This function is particularly useful when implementing custom navigation for your WordPress site.


    previous_posts( bool $display = true ): string|void


    • $display (bool, optional): This parameter determines whether the function should directly output (echo) the link to the browser or just return the link as a string. The parameter is optional and defaults to true.

    Return Value:

    • If $display is set to false, the function returns the link for the previous posts page as a string.
    • If $display is set to true, the function does not return anything (void); instead, it directly outputs the link to the browser.

    Sample Usage:

    1. Display the Link Directly:

      previous_posts(); // Echoes the link to the browser, as the default for $display is true
    2. Retrieve the Link as a String:

      $prev_posts_link = previous_posts(false); // Returns the link as a string instead of displaying it
      if ($prev_posts_link) {
          echo '<a href="' . esc_url($prev_posts_link) . '">Previous Posts</a>';

      In this example, the function is called with $display set to false. This makes the function return the link as a string, which is then stored in the variable $prev_posts_link. The link is then used to create an HTML anchor tag for the user to click.


    • It's important to ensure correct usage of $display based on whether you want to directly display the link or use it programmatically in your code.
    • When the link is output directly ($display = true), it's part of the HTML rendered to the user, making it immediately visible on the page.
    • When the link is returned as a string ($display = false), you have the flexibility to use it in various ways, like embedding it in different HTML structures or using it in conditional statements.

    This function is a part of WordPress's template tags and is commonly used in theme development for creating pagination or navigation through posts.

Leave an answer