A WordPress-centric search engine for devs and theme authors

add_{$meta_type}_metadata › WordPress Filter Hooks

apply_filters( "add_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $unique )
Parameters: (5)
  • (null|bool) $check Whether to allow adding metadata for the given type.
    Required: Yes
  • (int) $object_id ID of the object metadata is for.
    Required: Yes
  • (string) $meta_key Metadata key.
    Required: Yes
  • (mixed) $meta_value Metadata value. Must be serializable if non-scalar.
    Required: Yes
  • (bool) $unique Whether the specified meta key should be unique for the object.
    Required: Yes
Defined at:

Short-circuits adding 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:

  • add_post_metadata
  • add_comment_metadata
  • add_term_metadata
  • add_user_metadata


$check = apply_filters( "add_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $unique );