get_next_post_link( string $format = '%link »', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' ): string

Retrieves the next post link that is adjacent to the current post.

Parameters

$formatstringoptional: Link anchor format. Default ‘« %link’.
Default:'%link »'
$linkstringoptional: Link permalink format. Default '%title'.
Default:'%title'
$in_same_termbooloptional: Whether link should be in the same taxonomy term.

Default:false
$excluded_termsint[]|stringoptional: Array or comma-separated list of excluded term IDs.

Default:''
$taxonomystringoptional: Taxonomy, if $in_same_term is true. Default 'category'.
Default:'category'

Return

string The link URL of the next post in relation to the current post.

Source

function get_next_post_link( $format = '%link &raquo;', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	return get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, false, $taxonomy );
}

View all references View on Trac View on GitHub

Uses	Description
get_adjacent_post_link()`wp-includes/link-template.php`	Retrieves the adjacent post link.

Used by	Description
get_the_post_navigation()`wp-includes/link-template.php`	Retrieves the navigation to next/previous post, when applicable.
next_post_link()`wp-includes/link-template.php`	Displays the next post link that is adjacent to the current post.

Changelog

Version	Description
3.7.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.

get_next_post_link( string $format = '%link &raquo;', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' ): string

In this article