# unregister_meta_key()

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

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

## Сигнатура

```php
unregister_meta_key( string $object_type, string $meta_key, string $object_subtype = '' ): bool
```

## Описание

Отменяет регистрацию ключа метаданных из списка зарегистрированных ключей.

## Параметры

- `$object_type` `string` — обязательный. Тип объекта, к которому относятся метаданные. Принимает 'blog', 'post', 'comment', 'term', 'user' или любой другой тип объекта со связанной таблицей метаданных.
- `$meta_key` `string` — обязательный. Ключ метаданных.
- `$object_subtype` `string` — необязательный, по умолчанию `''`. Подтип типа объекта.

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

`bool`

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

Файл: `wp-includes/meta.php:1661`

```php
function unregister_meta_key( $object_type, $meta_key, $object_subtype = '' ) {
	global $wp_meta_keys;

	if ( ! registered_meta_key_exists( $object_type, $meta_key, $object_subtype ) ) {
		return false;
	}

	$args = $wp_meta_keys[ $object_type ][ $object_subtype ][ $meta_key ];

	if ( isset( $args['sanitize_callback'] ) && is_callable( $args['sanitize_callback'] ) ) {
		if ( ! empty( $object_subtype ) ) {
			remove_filter( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['sanitize_callback'] );
		} else {
			remove_filter( "sanitize_{$object_type}_meta_{$meta_key}", $args['sanitize_callback'] );
		}
	}

	if ( isset( $args['auth_callback'] ) && is_callable( $args['auth_callback'] ) ) {
		if ( ! empty( $object_subtype ) ) {
			remove_filter( "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['auth_callback'] );
		} else {
			remove_filter( "auth_{$object_type}_meta_{$meta_key}", $args['auth_callback'] );
		}
	}

	unset( $wp_meta_keys[ $object_type ][ $object_subtype ][ $meta_key ] );

	// Do some clean up.
	if ( empty( $wp_meta_keys[ $object_type ][ $object_subtype ] ) ) {
		unset( $wp_meta_keys[ $object_type ][ $object_subtype ] );
	}
	if ( empty( $wp_meta_keys[ $object_type ] ) ) {
		unset( $wp_meta_keys[ $object_type ] );
	}

	return true;
}
```

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

- 4.9.8 — The $object_subtype parameter was added.
- 4.6.0 — Introduced.

## Связанные

Использует: [`registered_meta_key_exists`](https://chugunov.pro/api-wordpress/functions/registered_meta_key_exists/), [`remove_filter`](https://chugunov.pro/api-wordpress/functions/remove_filter/).
Используется в: [`unregister_term_meta`](https://chugunov.pro/api-wordpress/functions/unregister_term_meta/), [`unregister_post_meta`](https://chugunov.pro/api-wordpress/functions/unregister_post_meta/).

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