W3cubDocs

/WordPress

delete_post_meta( int $post_id, string $meta_key, mixed $meta_value = '' )

Deletes a post meta field for the given post ID.

Description

You can match based on the key, or key and value. Removing based on key and value, will keep from removing duplicate metadata with the same key. It also allows removing all metadata matching the key, if needed.

Parameters

$post_id

(int) (Required) Post ID.

$meta_key

(string) (Required) Metadata name.

$meta_value

(mixed) (Optional) Metadata value. If provided, rows will only be removed that match the value. Must be serializable if non-scalar.

Default value: ''

Return

(bool) True on success, false on failure.

Source

File: wp-includes/post.php 

function delete_post_meta( $post_id, $meta_key, $meta_value = '' ) {
	// Make sure meta is added to the post, not a revision.
	$the_post = wp_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}

	return delete_metadata( 'post', $post_id, $meta_key, $meta_value );
}

Uses

Uses Description
wp-includes/revision.php: wp_is_post_revision()

Determines if the specified post is a revision.
wp-includes/meta.php: delete_metadata()

Deletes metadata for the specified object.

Used By

Used By Description
wp-includes/post.php: wp_check_for_changed_dates()

Check for changed dates for published post objects and save the old date.
wp-admin/includes/class-wp-privacy-policy-content.php: WP_Privacy_Policy_Content::get_suggested_policy_text()

Check for updated, added or removed privacy policy information from plugins.
wp-admin/includes/class-wp-privacy-policy-content.php: WP_Privacy_Policy_Content::_policy_page_updated()

Update the cached policy info when the policy page is updated.
wp-admin/includes/privacy-tools.php: wp_privacy_process_personal_data_export_page()

Intercept personal data exporter page Ajax responses in order to assemble the personal data export file.
wp-admin/includes/privacy-tools.php: wp_privacy_generate_personal_data_export_file()

Generate the personal data export file.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::handle_dismiss_autosave_or_lock_request()

Delete a given auto-draft changeset or the autosave revision for a given changeset or delete changeset lock.
wp-includes/nav-menu.php: _wp_delete_customize_changeset_dependent_auto_drafts()

Delete auto-draft posts associated with the supplied changeset.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::save_nav_menus_created_posts()

Publish the auto-draft posts that were created for nav menu items.
wp-admin/includes/class-custom-image-header.php: Custom_Image_Header::ajax_header_remove()

Given an attachment ID for a header image, unsets it as a user-uploaded header image for the current theme.
wp-includes/functions.php: wp_scheduled_delete()

Permanently delete comments or posts of any type that have held a status of ‘trash’ for the number of days defined in EMPTY_TRASH_DAYS.
wp-includes/class-wp-embed.php: WP_Embed::delete_oembed_caches()

Delete all oEmbed caches. Unused by core as of 4.0.0.
wp-includes/post.php: set_post_thumbnail()

Sets the post thumbnail (featured image) for the given post.
wp-includes/post.php: delete_post_thumbnail()

Removes the thumbnail (featured image) from the given post.
wp-includes/post.php: wp_check_for_changed_slugs()

Check for changed slugs for published post objects and save the old slug.
wp-includes/post.php: wp_delete_attachment()

Trash or delete an attachment.
wp-includes/post.php: wp_update_attachment_metadata()

Updates metadata for an attachment.
wp-includes/post.php: wp_untrash_post_comments()

Restore comments for a post from the Trash.
wp-includes/post.php: wp_insert_post()

Insert or update a post.
wp-includes/post.php: wp_delete_post()

Trash or delete a post or page.
wp-includes/post.php: wp_untrash_post()

Restore a post or page from the Trash.
wp-includes/post.php: update_attached_file()

Update attachment file path based on attachment ID.
wp-includes/nav-menu.php: wp_update_nav_menu_item()

Save the properties of a menu item or create a new one.
wp-includes/comment.php: do_all_pings()

Perform all pingbacks, enclosures, trackbacks, and send to pingback services.

Changelog

Version Description
1.5.0 Introduced.

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