previous_posts_link( string $label = null )
Displays the previous posts page link.
Parameters
-
$labelstring Optional -
Previous page link text.
Default:
null
More Information
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).
Source
File: wp-includes/link-template.php.
View all references
function previous_posts_link( $label = null ) {
echo get_previous_posts_link( $label );
}
Changelog
| Version | Description |
|---|---|
| 0.71 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example
Check if previous link exists (From Codex)
A warning when using with custom queries
This function
previous_posts_link()has a condition to run ifis_single()isfalse.This is good to know when creating custom queries and adding pagination using this function because where you place your custom query can change whether the pagination shows or not.
What’s interesting is that:
–
is_single()doesn’t work on pages (or media)–
is_single()does work on CPTs and postsSo custom queries with this pagination placed on a single page will work fine, but add the same custom query + pagination to a single CPT or post, and it will not show.