# delete_post_meta_by_key()

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

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

## Сигнатура

```php
delete_post_meta_by_key( string $post_meta_key ): bool
```

## Описание

Удаляет из метаданных записей всё, что совпадает с указанным ключом метаданных.

## Параметры

- `$post_meta_key` `string` — обязательный. Ключ для поиска при удалении.

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

`bool`

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

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

```php
function delete_post_meta_by_key( $post_meta_key ) {
	return delete_metadata( 'post', null, $post_meta_key, '', true );
}
```

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

- 2.3.0 — Introduced.

## Связанные

Использует: [`delete_metadata`](https://chugunov.pro/api-wordpress/functions/delete_metadata/).

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