the_permalink( int|WP_Post $post )

Displays the permalink for the current post.

Contents

Description Description

Parameters Parameters

$post

(int|WP_Post) (Optional) Post ID or post object. Default is the global $post.

Top ↑

Source Source

File: wp-includes/link-template.php

17
18
19
20
21
22
23
24
25
26
27
28
function the_permalink( $post = 0 ) {
    /**
     * Filters the display of the permalink for the current post.
     *
     * @since 1.5.0
     * @since 4.4.0 Added the `$post` parameter.
     *
     * @param string      $permalink The permalink for the current post.
     * @param int|WP_Post $post      Post ID, WP_Post object, or 0. Default 0.
     */
    echo esc_url( apply_filters( 'the_permalink', get_permalink( $post ), $post ) );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
4.4.0 Added the $post parameter.
1.2.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/link-template.php: get_permalink()

Retrieves the full permalink for the current post or post ID.
wp-includes/link-template.php: the_permalink

Filters the display of the permalink for the current post.
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/embed.php: print_embed_sharing_dialog()

Prints the necessary markup for the embed sharing dialog.
wp-includes/deprecated.php: permalink_link()

Print the permalink of the current post in the loop.
wp-includes/widgets/class-wp-widget-recent-posts.php: WP_Widget_Recent_Posts::widget()

Outputs the content for the current Recent Posts widget instance.
wp-includes/comment-template.php: trackback_rdf()

Generate and display the RDF for the trackback information of current post.

Top ↑

User Contributed Notes User Contributed Notes

  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Used as Link With Title Tag
    Creates a link for the permalink, with the post’s title as the link text. This is a common way to put the post’s title.

    1
    <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>

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