get_the_guid( int|WP_Post $post ): string

Retrieves the Post Global Unique Identifier (guid).

Description

The guid will appear to be a link, but should not be used as an link to the post. The reason you should not use it as a link, is because of moving the blog across domains.

Parameters

$postint|WP_Postoptional: Post ID or post object. Default is global $post.

Return

string

Source

function get_the_guid( $post = 0 ) {
	$post = get_post( $post );

	$post_guid = $post->guid ?? '';
	$post_id   = $post->ID ?? 0;

	/**
	 * Filters the Global Unique Identifier (guid) of the post.
	 *
	 * @since 1.5.0
	 *
	 * @param string $post_guid Global Unique Identifier (guid) of the post.
	 * @param int    $post_id   The post ID.
	 */
	return apply_filters( 'get_the_guid', $post_guid, $post_id );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘get_the_guid’, string $post_guid, int $post_id ): Filters the Global Unique Identifier (guid) of the post.

Uses	Description
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.
get_post()`wp-includes/post.php`	Retrieves post data given a post ID or post object.

Used by	Description
get_comment_guid()`wp-includes/feed.php`	Retrieves the feed GUID for the current comment.
the_guid()`wp-includes/post-template.php`	Displays the Post Global Unique Identifier (guid).
_transition_post_status()`wp-includes/post.php`	Hook for managing future post transitions to published.
wp_get_attachment_url()`wp-includes/post.php`	Retrieves the URL for an attachment.

Changelog

Version	Description
1.5.0	Introduced.

User Contributed Notes

Skip to note 2 content

jesus0903 4 months ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Although “GUID” stands for Globally Unique Identifier, WordPress does not enforce a uniqueness constraint on the database level. In some cases—particularly when using plugins that publish posts without going through a draft state—multiple posts may share the same GUID value.

You should not use the GUID as a unique key for querying posts. Instead, use the post ID to guarantee uniqueness.

Log in to add feedback

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

get_the_guid( int|WP_Post $post ): string

In this article