the_permalink( int|WP_Post $post = 0 )

Parameters

$postint|WP_Postoptional

Post ID or post object. Default is the global $post.Default: 0

Hooks fired · 1

One hook fires while the_permalink() runs, in this order:

1. 1
   apply_filters( the_permalink )filterline 27 (+10 into the body)

   Filters the display of the permalink for the current post.

Uses · 3

• esc_url()Checks and cleans a URL.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_permalink()Retrieves the full permalink for the current post or post ID.

Used by · 11

• Twenty_Fourteen_Ephemera_Widget::widget()Output the HTML for this widget.
• WP_Widget_Recent_Posts::widget()Outputs the content for the current Recent Posts widget instance.
• permalink_link()Print the permalink of the current post in the loop.
• print_embed_sharing_dialog()Prints the necessary markup for the embed sharing dialog.
• trackback_rdf()Generates and displays the RDF for the trackback information of current post.
• twenty_twenty_one_post_thumbnail()Displays an optional post thumbnail.
• twentyfifteen_post_thumbnail()Display an optional post thumbnail.
• twentyfourteen_post_thumbnail()Display an optional post thumbnail.
• twentynineteen_post_thumbnail()Displays an optional post thumbnail.
• twentysixteen_post_thumbnail()Displays an optional post thumbnail.
• twentytwenty_get_post_meta()Retrieves the post meta.

Source

View on Trac ↗View on GitHub ↗

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

History

Introduced in 1.2.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/link-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.