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

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


Top ↑

See also

Top ↑


$format string Optional
Link anchor format. Default '« %link'.

Default: '%link »'

$link string Optional
Link permalink format. Default '%title'.

Default: '%title'

$in_same_term bool Optional
Whether link should be in the same taxonomy term.

Default: false

$excluded_terms int[]|string Optional
Array or comma-separated list of excluded term IDs.

Default: ''

$taxonomy string Optional
Taxonomy, if $in_same_term is true. Default 'category'.

Default: 'category'

Top ↑


File: wp-includes/link-template.php. View all references

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 ↑


Version Description
1.5.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Mohammad AbuDayeh

    Hola, If you use the Bootstrap, you will encounter a problem in not being able to modify the class (a),

    These are in the single.php file :

    <ul class="pagination justify-content-center mb-4">
    	<ul class="pagination justify-content-center mb-4">
    		<li class="page-item">
    			<?php next_post_link( '%link', '<i class="fas fa-arrow-right"></i> %title' ); ?>
    	        <li class="page-item">
    		        <?php previous_post_link( '%link', '%title <i class="fas fa-arrow-left"></i>' ); ?>

    This is in the functions.php file :

    function wpdocs_add_post_link( $html ){
    	$html = str_replace( '<a ', '<a class="page-link" ', $html );
    	return $html;
    add_filter( 'next_post_link', 'wpdocs_add_post_link' );
    add_filter( 'previous_post_link', 'wpdocs_add_post_link' );

    I used FontAwesome for the icons that you can change as you like

  2. Skip to note 3 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' ); ?>
  3. Skip to note 7 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.

  4. Skip to note 8 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.