WordPress get_permalink Example: Build Canonical Post Links Correctly

Last reviewed: May 13, 2026

Building post links by concatenating slugs or assuming global loop state is one of the quieter ways WordPress code becomes brittle. get_permalink() is the canonical helper for retrieving the final public URL of a post, page, attachment, or custom post type item when a real post context exists.

This guide shows how to use get_permalink() safely, why passing the post explicitly matters, and where the helper can return surprising results if the calling code depends on global state.

Pass the post ID or object explicitly when outside a narrow loop context

<?php
$url = get_permalink( $post_id );

if ( $url ) {
	echo '<a href="' . esc_url( $url ) . '">'
		. esc_html__( 'Read the full article', 'vulnwp' )
		. '</a>';
}

That pattern is safer than assuming the global $post is pointing at the item you meant to link.

Remember that the helper can return false

The code reference is explicit: if the post does not exist, get_permalink() returns false. Front-end rendering code should treat that as a real branch, not an impossible one.

Do not rely on global loop behavior outside of clear template contexts

Outside The Loop, archive templates and custom queries can make link retrieval harder to reason about if the helper is called without a post parameter. Explicit IDs or post objects make the result stable and reviewable.

Common mistakes

• Concatenating slugs onto guessed site URLs. WordPress already owns permalink generation.
• Calling get_permalink() without a post argument in ambiguous contexts. Global state can surprise you.
• Skipping the false branch. Missing posts should be handled explicitly.
• Rendering the result without esc_url(). Canonical generation and output escaping are separate steps.

Production checklist

• Pass a post ID or WP_Post explicitly whenever the context is not trivial.
• Handle the possibility of false return values.
• Escape rendered links with esc_url().
• Let WordPress build canonical post URLs instead of hand-assembling them.
• Retest link logic after permalink structure changes.

Related reading

Pair this with the home_url guide for site-level URL construction and with the esc_url article for safe final output rendering.

References and further reading

• WordPress Code Reference: get_permalink()
• WordPress Code Reference: get_the_permalink()
• WordPress Code Reference: esc_url()