WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/get next posts link

Contents

Description

Gets a link to the previous set of posts within the current query.

Because post queries are usually sorted in reverse chronological order, get_next_posts_link() usually points to older entries (toward the end of the set) and get_previous_posts_link() usually points to newer entries (toward the beginning of the set).

Note: See Troubleshooting Broken Pagination if you have pagination issues.

Usage

 <?php echo get_next_posts_link$label$max_page ); ?> 

Parameters

$label
(string) (optional) The content for the link text
Default: Next Page »
$max_page
(int) (optional) Limit the number of pages on which the link is displayed. The default value "0" means "no limit".
Default: 0

Return Values

Link to next page if successful, otherwise null.

Examples

Default Usage

<?php echo get_next_posts_link(); ?>

Custom Label

<?php echo get_next_posts_link('Go to next page'); ?>

Custom Label and Custom number of post pages

<?php echo get_next_posts_link('Go to next page',4); ?>

Usage when querying the loop with WP_Query

Add the $max_pages parameter to the get_next_posts_link() function when querying the loop with WP_Query. To get the total amount of pages you can use the 'max_num_pages' property of the custom WP_Query object.

<?php
// set the "paged" parameter (use 'page' if the query is on a static front page)
$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;

// the query
$the_query = new WP_Query( 'cat=1&paged=' . $paged ); 
?>

<?php if ( $the_query->have_posts() ) : ?>

<?php
// the loop
while ( $the_query->have_posts() ) : $the_query->the_post(); 
?>
<?php the_title(); ?>
<?php endwhile; ?>

<?php

// get_next_posts_link() usage with max_num_pages
echo get_next_posts_link( 'Older Entries', $the_query->max_num_pages );
echo get_previous_posts_link( 'Newer Entries' );
?>

<?php 
// clean up after our query
wp_reset_postdata(); 
?>

<?php else:  ?>
<p><?php _e( 'Sorry, no posts matched your criteria.' ); ?></p>
<?php endif; ?>

Change Log

Since 2.7.0

Source File

get_next_posts_link() is located in wp-includes/link-template.php.

Related