WordPress.org

Languages: English • 日本語 (Add your language)

Description

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

If you need the values for use in PHP, use get_previous_posts_link().

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

Usage

 <?php previous_posts_link( $label ); ?> 

Parameters

$label

(string) (optional) The link text.

Default: '« Previous Page'

Examples

Default Usage

<?php previous_posts_link(); ?>

Working example

<?php previous_posts_link( '« Newer Entries' ); ?>

Check if previous link exists

<?php if( get_previous_posts_link() ) :

previous_posts_link( '« Newer Entries' );

endif; ?>

Notes

• See also: next_posts_link() and previous_post_link().

• This function does not work with static pages.

Resources

• Digging into Wordpress - Definitive Guide to WordPress Page Navigation

Change Log

Since: 0.71

Source File

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

Related

• Article: Pagination
• Function: posts_nav_link()
• Function: next_posts_link()
• Function: previous_posts_link()
• Function: get_next_posts_link()
• Function: get_previous_posts_link()
• Function: paginate_links()

• Function: wp_link_pages()
• Function: next_post_link()
• Function: previous_post_link()
• Function: next_image_link()
• Function: previous_image_link()

• Function: the_posts_pagination()
• Function: get_the_posts_pagination()

• Function: the_post_navigation()
• Function: get_the_post_pagination()

• Article: Making Custom Queries using Offset and Pagination