WordPress at a glance

delete_user_meta() WP 1.0

Remove metadata matching criteria from a user.

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 key, if needed.

Is the basis for: delete_user_option()
Works based on: delete_metadata()

No Hooks.


true/false. True on success, false on failure.


delete_user_meta( $user_id, $meta_key, $meta_value );
$user_id(int) (required)
User ID
$meta_key(string) (required)
Metadata name.
Metadata value.
Default: ''


Since 3.0.0 Introduced.

Code of delete user meta: wp-includes/user.php WP 5.4.2

function delete_user_meta( $user_id, $meta_key, $meta_value = '' ) {
	return delete_metadata( 'user', $user_id, $meta_key, $meta_value );

Related Functions

From tag: Metadatas (any)

No comments
        Log In . Register