get_post_thumbnail_id( int|WP_Post $post = null )

Retrieve post thumbnail ID.

Parameters

$post

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

Default value: null

Return

(string|int) Post thumbnail ID or empty string.

Source

File: wp-includes/post-thumbnail-template.php 

function get_post_thumbnail_id( $post = null ) {
	$post = get_post( $post );
	if ( ! $post ) {
		return '';
	}
	return get_post_meta( $post->ID, '_thumbnail_id', true );
}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/post.php: get_post_meta()

Retrieve post meta field for a post.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.

Used By

Used By
Used By Description
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::prepare_item_for_response()

Prepares a single post output for response.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::prepare_links()

Prepares links for the request.
wp-includes/media.php: wp_prepare_attachment_for_js()

Prepares an attachment post object for JS, where it is expected to be JSON-encoded and fit into an Attachment model.
wp-includes/media.php: wp_playlist_shortcode()

Builds the Playlist shortcode output.
wp-includes/embed.php: get_oembed_response_data_rich()

Filters the oEmbed response data to return an iframe embed code.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_getPost()

Retrieve post.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_getRecentPosts()

Retrieve list of recent posts.
wp-includes/post-thumbnail-template.php: has_post_thumbnail()

Check if post has an image attached.
wp-includes/post-thumbnail-template.php: update_post_thumbnail_cache()

Update cache for thumbnails in the current loop.
wp-includes/post-thumbnail-template.php: get_the_post_thumbnail()

Retrieve the post thumbnail.
wp-includes/post-thumbnail-template.php: get_the_post_thumbnail_url()

Return the post thumbnail URL.
wp-includes/post-thumbnail-template.php: get_the_post_thumbnail_caption()

Returns the post thumbnail caption.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::_prepare_post()

Prepares post data for return in an XML-RPC object.
wp-includes/post-template.php: prepend_attachment()

Wrap attachment in paragraph tag before content.
wp-admin/includes/media.php: edit_form_image_editor()

Displays the image and editor in the post editor
wp-admin/includes/media.php: get_media_item()

Retrieve HTML form for modifying the image attachment.
Show 11 more used by Hide more used by

Changelog

Changelog
Version Description
WP-4.4.0 $post can be a post ID or WP_Post object.
WP-2.9.0 Introduced.