wordpress / latest / functions / delete_user_meta.html

delete_user_meta( int $user_id, string $meta_key, mixed $meta_value = '' ): bool

Removes metadata matching criteria from a user.

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

Parameters

$user_id int Required
User 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: ''

Return

bool True on success, false on failure.

Source

File: wp-includes/user.php. View all references

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

Uses

Uses Description

Used By

Used By Description

Changelog

Version Description
3.0.0 Introduced.

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