get_the_permalink() WP 3.9.0

Gets, rather than displays, the URL of the post that is currently being processed in the Loop. Template tag.

No Hooks.

Return

String/false. The permalink URL or false if post does not exist.

Usage

get_the_permalink( $post, $leavename );

$post(int/WP_Post)

Post ID or post object, which link we want to retrieve.
Default: global $post

$leavename(true/false)

Do not replace the name of the post in the link, i.e. do not replace the tag %postname% with the name of the post.
Default: false

Examples

#1 Example of use

Get a link to the current post in the loop:

<a href="<?php echo get_the_permalink(); ?>">Reed more...</a>

#2 Get the link to a specific post

$url = get_the_permalink( 23 ); // http://site.com/post-name/

#3 Second parameter: $leavename

The result depends on the permalink structure. Suppose that we have such a structure: %post_id%/%postname%.html, then:

$url = get_the_permalink( 23 );
echo get_the_permalink( 1, true );

// display: http://domain.com/1/%postname%.html

Notes

• See: get_permalink()

Changelog

Code of get the permalink: wp-includes/link-template.php ^{WP 5.3.2}

<?php
function get_the_permalink( $post = 0, $leavename = false ) {
	return get_permalink( $post, $leavename );
}

Related Functions

From tag: permalinks (clean friendly URL)

More from category: Posts, pages...