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

$format

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

Default value: '%link »'

$link

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

Default value: '%title'

$in_same_term

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

Default value: false

$excluded_terms

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

Default value: ''

$taxonomy

(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

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 5 content

    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>
    	        <li class="page-item">
    		        <?php previous_post_link( '%link', '%title <i class="fas fa-arrow-left"></i>' ); ?>
    	        </li>
    	</ul>
    </ul>

    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

  3. Skip to note 6 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 7 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.