# delete_post_meta()

URL: https://chugunov.pro/api-wordpress/functions/delete_post_meta/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 1.5.0.

## Сигнатура

```php
delete_post_meta( int $post_id, string $meta_key, mixed $meta_value = '' ): bool
```

## Описание

Совпадение можно искать по ключу либо по ключу и значению. Удаление по ключу и значению позволяет не удалять дублирующиеся метаданные с тем же ключом. При необходимости также можно удалить все метаданные, совпадающие с ключом.
По историческим причинам и ключ метаданных, и значение метаданных на входе ожидаются «со слэшами» (с экранированными слэшами).

## Параметры

- `$post_id` `int` — обязательный. Идентификатор записи.
- `$meta_key` `string` — обязательный. Имя метаданных.
- `$meta_value` `mixed` — необязательный, по умолчанию `''`. Значение метаданных. Если указано, будут удалены только строки, соответствующие этому значению.
  
  Если значение не скалярное, оно должно быть сериализуемым.

## Возвращаемое значение

`bool`

## Исходный код

Файл: `wp-includes/post.php:2675`

```php
function delete_post_meta( $post_id, $meta_key, $meta_value = '' ) {
	// Make sure meta is deleted from the post, not from a revision.
	$the_post = wp_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}

	return delete_metadata( 'post', $post_id, $meta_key, $meta_value );
}
```

## История изменений

- 1.5.0 — Introduced.

## Связанные

Использует: [`wp_is_post_revision`](https://chugunov.pro/api-wordpress/functions/wp_is_post_revision/), [`delete_metadata`](https://chugunov.pro/api-wordpress/functions/delete_metadata/).
Используется в: [`wp_restore_post_revision_meta`](https://chugunov.pro/api-wordpress/functions/wp_restore_post_revision_meta/), [`do_all_trackbacks`](https://chugunov.pro/api-wordpress/functions/do_all_trackbacks/), [`do_all_enclosures`](https://chugunov.pro/api-wordpress/functions/do_all_enclosures/), [`do_all_pingbacks`](https://chugunov.pro/api-wordpress/functions/do_all_pingbacks/), [`wp_check_for_changed_dates`](https://chugunov.pro/api-wordpress/functions/wp_check_for_changed_dates/), `WP_Privacy_Policy_Content::get_suggested_policy_text`, `WP_Privacy_Policy_Content::_policy_page_updated`, [`wp_privacy_process_personal_data_export_page`](https://chugunov.pro/api-wordpress/functions/wp_privacy_process_personal_data_export_page/), [`wp_privacy_generate_personal_data_export_file`](https://chugunov.pro/api-wordpress/functions/wp_privacy_generate_personal_data_export_file/), `WP_Customize_Manager::handle_dismiss_autosave_or_lock_request`, [`_wp_delete_customize_changeset_dependent_auto_drafts`](https://chugunov.pro/api-wordpress/functions/_wp_delete_customize_changeset_dependent_auto_drafts/), `WP_Customize_Nav_Menus::save_nav_menus_created_posts`, [`wp_restore_image`](https://chugunov.pro/api-wordpress/functions/wp_restore_image/), `Custom_Image_Header::ajax_header_remove`, [`wp_scheduled_delete`](https://chugunov.pro/api-wordpress/functions/wp_scheduled_delete/), `WP_Embed::delete_oembed_caches`, [`set_post_thumbnail`](https://chugunov.pro/api-wordpress/functions/set_post_thumbnail/), [`delete_post_thumbnail`](https://chugunov.pro/api-wordpress/functions/delete_post_thumbnail/), [`wp_check_for_changed_slugs`](https://chugunov.pro/api-wordpress/functions/wp_check_for_changed_slugs/), [`wp_delete_attachment`](https://chugunov.pro/api-wordpress/functions/wp_delete_attachment/), [`wp_update_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_update_attachment_metadata/), [`wp_untrash_post_comments`](https://chugunov.pro/api-wordpress/functions/wp_untrash_post_comments/), [`wp_insert_post`](https://chugunov.pro/api-wordpress/functions/wp_insert_post/), [`wp_delete_post`](https://chugunov.pro/api-wordpress/functions/wp_delete_post/), [`wp_untrash_post`](https://chugunov.pro/api-wordpress/functions/wp_untrash_post/), [`update_attached_file`](https://chugunov.pro/api-wordpress/functions/update_attached_file/), [`wp_update_nav_menu_item`](https://chugunov.pro/api-wordpress/functions/wp_update_nav_menu_item/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/delete_post_meta/