# get_metadata()

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

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

## Сигнатура

```php
get_metadata( string $meta_type, int $object_id, string $meta_key = '', bool $single = false ): mixed
```

## Описание

Если поле метаданных существует, возвращается одно значение, когда $single равно true, или массив значений, когда оно равно false.
Если поле метаданных не существует, результат зависит от get_metadata_default() .
По умолчанию возвращается пустая строка, когда $single равно true, или пустой массив, когда оно равно false.
См. alsoget_metadata_raw()

get_metadata_default()

## Параметры

- `$meta_type` `string` — обязательный. Тип объекта, к которому относятся метаданные. Принимает 'blog', 'post', 'comment', 'term', 'user' или любой другой тип объекта со связанной таблицей метаданных.
- `$object_id` `int` — обязательный. ID объекта, к которому относятся метаданные.
- `$meta_key` `string` — необязательный, по умолчанию `''`. Ключ метаданных. Если не указан, получаются все метаданные для указанного объекта.
- `$single` `bool` — необязательный, по умолчанию `false`. Если true, возвращается только первое значение указанного $meta_key.
  
  Этот параметр не действует, если $meta_key не указан.

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

`mixed` — $single $single $object_id $meta_type $single $single значения false возвращаются как пустые строки ('') значения true возвращаются как '1' числа (как целые, так и с плавающей точкой) возвращаются как строки. Массивы и объекты сохраняют свой исходный тип.

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

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

```php
function get_metadata( $meta_type, $object_id, $meta_key = '', $single = false ) {
	$value = get_metadata_raw( $meta_type, $object_id, $meta_key, $single );
	if ( ! is_null( $value ) ) {
		return $value;
	}

	return get_metadata_default( $meta_type, $object_id, $meta_key, $single );
}
```

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

- 2.9.0 — Introduced.

## Связанные

Использует: [`get_metadata_default`](https://chugunov.pro/api-wordpress/functions/get_metadata_default/), [`get_metadata_raw`](https://chugunov.pro/api-wordpress/functions/get_metadata_raw/).
Используется в: [`get_site_meta`](https://chugunov.pro/api-wordpress/functions/get_site_meta/), `WP_REST_Meta_Fields::update_value`, `WP_REST_Meta_Fields::get_value`, [`get_registered_metadata`](https://chugunov.pro/api-wordpress/functions/get_registered_metadata/), [`get_term_meta`](https://chugunov.pro/api-wordpress/functions/get_term_meta/), [`get_user_meta`](https://chugunov.pro/api-wordpress/functions/get_user_meta/), [`get_post_meta`](https://chugunov.pro/api-wordpress/functions/get_post_meta/), [`get_comment_meta`](https://chugunov.pro/api-wordpress/functions/get_comment_meta/).

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