The get_permalink() WordPress function

Within your WordPress theme or plugin, you may need to obtain the post permalink. In this article, we will introduce you to the get_permalink() function which you may use to obtain the permalink of either your current post or another desired post.

If you would like more information on creating WordPress plugins, see our tutorial series on creating your first WordPress plugin.

Basic usage

<?php $permalink = get_permalink( $id ); ?>

This this example, we are simply getting the post permalink from a desired post using the $id parameter, and assigning it to the $permalink variable.

Parameters

$id: This optional parameter allows you to manually define the ID of the post that you want to get the permalink of. This parameter takes an integer such as 5 for post ID 5.

$leavename: This optional parameter takes a true or false boolean operator. Instead of displaying the full permalink, it will display your permalink structure such as https://example.com/%postname%/.

Examples

Display the permalink of a specific post

In the following code example, we are getting the permalink of the post with ID 5, and assigning it to a variable. Then, we are displaying the contents of that variable:

<?php
$permalink = get_permalink(5);
echo $permalink;
?>

Display the permalink structure of a specific post

In this example, we are getting the permalink structure of the post with ID 5 and assigning it to a new variable. Then, we are displaying that permalink structure:

<?php
$permalink = get_permalink(5, true);
echo $permalink;
?>

References

For more information on the get_permalink() WordPress function, take a look at the get_permalink() WordPress Codex page.

Was this article helpful? Join the conversation!