apply_filters( "delete_{$meta_type}_metadata", null|bool $delete, int $object_id, string $meta_key, mixed $meta_value, bool $delete_all )

Short-circuits deleting metadata of a specific type.


The dynamic portion of the hook name, $meta_type, refers to the meta object type (post, comment, term, user, or any other type with an associated meta table). Returning a non-null value will effectively short-circuit the function.

Possible hook names include:

  • delete_post_metadata
  • delete_comment_metadata
  • delete_term_metadata
  • delete_user_metadata

Top ↑



(null|bool) Whether to allow metadata deletion of the given type.


(int) ID of the object metadata is for.


(string) Metadata key.


(mixed) Metadata value. Must be serializable if non-scalar.


(bool) Whether to delete the matching metadata entries for all objects, ignoring the specified $object_id. Default false.

Top ↑


File: wp-includes/meta.php

View on Trac

Top ↑


Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes

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