W3cubDocs

/WordPress

delete_post_thumbnail( int|WP_Post $post )

Removes the thumbnail (featured image) from the given post.

Parameters

$post

(int|WP_Post) (Required) Post ID or post object from which the thumbnail should be removed.

Return

(bool) True on success, false on failure.

Source

File: wp-includes/post.php 

function delete_post_thumbnail( $post ) {
	$post = get_post( $post );
	if ( $post ) {
		return delete_post_meta( $post->ID, '_thumbnail_id' );
	}
	return false;
}

Uses

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

Deletes a post meta field for the given post ID.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.

Used By

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

Determines the featured media based on a request param.
wp-admin/includes/ajax-actions.php: wp_ajax_set_post_thumbnail()

Ajax handler for setting the featured image.
wp-includes/post.php: wp_insert_post()

Insert or update a post.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_editPost()

Edit a post.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::_insert_post()

Helper method for wp_newPost() and wp_editPost(), containing shared logic.

Changelog

Version Description
3.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/delete_post_thumbnail