delete_comment_meta( int $comment_id, string $meta_key, mixed $meta_value = '' ): bool

Removes metadata matching criteria from a comment.

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

$comment_idintrequired
Comment ID.
$meta_keystringrequired
Metadata name.
$meta_valuemixedoptional
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

wp-includes/comment.php
function delete_comment_meta( $comment_id, $meta_key, $meta_value = '' ) {
	return delete_metadata( 'comment', $comment_id, $meta_key, $meta_value );
}

Changelog

VersionDescription
2.9.0Introduced.

User Contributed Notes

  1. Skip to note 2 content

    Delete all metadata with the key ‘my_meta_key’ for comment ID 5.

    wp-includes/comment.php
    delete_comment_meta( 5, 'my_meta_key' );

    Delete metadata for ‘my_meta_key’ only where the meta_value is ‘foo’.

    wp-includes/comment.php
    delete_comment_meta( 5, 'my_meta_key', 'foo' );

You must log in before being able to contribute a note or feedback.