next_post_link( string $format = '%link »', string $link = '%title', bool $in_same_term = false, array|string $excluded_terms = '', string $taxonomy = 'category' )

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

Description Description

See also See also

Top ↑

Parameters Parameters


(string) (Optional) Link anchor format. Default '« %link'.

Default value: '%link »'


(string) (Optional) Link permalink format. Default '%title'

Default value: '%title'


(bool) (Optional) Whether link should be in a same taxonomy term.

Default value: false


(array|string) (Optional) Array or comma-separated list of excluded term IDs.

Default value: ''


(string) (Optional) Taxonomy, if $in_same_term is true.

Default value: 'category'

Top ↑

Source Source

File: wp-includes/link-template.php

function next_post_link( $format = '%link »', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	echo get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );

Top ↑

Changelog Changelog

Version Description
1.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    Within Same Category, Excluding One
    Displays link to next post in the same category, as long as it is not in category 13 (the category ID #). You can change the number to any category you wish to exclude. Exclude multiple categories by using ” and ” as a delimiter.

    <?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>
  2. Skip to note 4 content
    Contributed by Codex

    Example: Default Usage
    Displays link to the next post (chronologically by publish date) with the post title as the link text, followed by a right angle quote (“My Next Post Title »”).

    <?php next_post_link(); ?>

    If there is no next post, the function does not print anything.

  3. Skip to note 5 content
    Contributed by Codex

    Text As Link, Without Post Title, Within Same Category
    Displays custom text as link to the next post within the same category as the current post. Post title is not included here. “Next post in category” is the custom text in this example.

    <?php next_post_link( '%link', 'Next post in category', TRUE ); ?>

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