# get_post_meta()

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

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

## Сигнатура

```php
get_post_meta( int $post_id, string $key = '', bool $single = false ): mixed
```

## Описание

Возвращает метаполе записи для указанного ID записи.

## Параметры

- `$post_id` `int` — обязательный. Идентификатор записи.
- `$key` `string` — необязательный, по умолчанию `''`. Ключ метаданных для получения. По умолчанию возвращает данные для всех ключей.
- `$single` `bool` — необязательный, по умолчанию `false`. Возвращать ли одно значение.
  
  Этот параметр не действует, если не указан $key.

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

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

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

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

```php
function get_post_meta( $post_id, $key = '', $single = false ) {
	return get_metadata( 'post', $post_id, $key, $single );
}
```

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

- 1.5.0 — Introduced.

## Связанные

Использует: [`get_metadata`](https://chugunov.pro/api-wordpress/functions/get_metadata/).
Используется в: [`apply_block_hooks_to_content_from_post_object`](https://chugunov.pro/api-wordpress/functions/apply_block_hooks_to_content_from_post_object/), [`update_ignored_hooked_blocks_postmeta`](https://chugunov.pro/api-wordpress/functions/update_ignored_hooked_blocks_postmeta/), [`_wp_before_delete_font_face`](https://chugunov.pro/api-wordpress/functions/_wp_before_delete_font_face/), [`_block_bindings_post_meta_get_value`](https://chugunov.pro/api-wordpress/functions/_block_bindings_post_meta_get_value/), [`inject_ignored_hooked_blocks_metadata_attributes`](https://chugunov.pro/api-wordpress/functions/inject_ignored_hooked_blocks_metadata_attributes/), [`_wp_preview_meta_filter`](https://chugunov.pro/api-wordpress/functions/_wp_preview_meta_filter/), [`_wp_copy_post_meta`](https://chugunov.pro/api-wordpress/functions/_wp_copy_post_meta/), [`wp_check_revisioned_meta_fields_have_changed`](https://chugunov.pro/api-wordpress/functions/wp_check_revisioned_meta_fields_have_changed/), [`wp_autosave_post_revisioned_meta_fields`](https://chugunov.pro/api-wordpress/functions/wp_autosave_post_revisioned_meta_fields/), [`update_menu_item_cache`](https://chugunov.pro/api-wordpress/functions/update_menu_item_cache/), [`_build_block_template_result_from_post`](https://chugunov.pro/api-wordpress/functions/_build_block_template_result_from_post/), [`get_media_states`](https://chugunov.pro/api-wordpress/functions/get_media_states/), `WP_REST_Attachments_Controller::edit_media_item`, [`get_post_states`](https://chugunov.pro/api-wordpress/functions/get_post_states/), `WP_User_Request::__construct`, [`_wp_privacy_send_request_confirmation_notification`](https://chugunov.pro/api-wordpress/functions/_wp_privacy_send_request_confirmation_notification/), [`_wp_privacy_send_erasure_fulfillment_notification`](https://chugunov.pro/api-wordpress/functions/_wp_privacy_send_erasure_fulfillment_notification/), [`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::text_change_check`, `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_privacy_send_personal_data_export_email`](https://chugunov.pro/api-wordpress/functions/wp_privacy_send_personal_data_export_email/), `WP_Customize_Manager::set_changeset_lock`, `WP_Customize_Manager::refresh_changeset_lock`, `WP_Customize_Manager::import_theme_starter_content`, `WP_REST_Attachments_Controller::prepare_item_for_response`, `WP_Customize_Nav_Menus::save_nav_menus_created_posts`, [`get_custom_logo`](https://chugunov.pro/api-wordpress/functions/get_custom_logo/), [`get_header_image_tag`](https://chugunov.pro/api-wordpress/functions/get_header_image_tag/), [`wp_ajax_crop_image`](https://chugunov.pro/api-wordpress/functions/wp_ajax_crop_image/), [`wp_restore_image`](https://chugunov.pro/api-wordpress/functions/wp_restore_image/), [`wp_save_image`](https://chugunov.pro/api-wordpress/functions/wp_save_image/), [`wp_image_editor`](https://chugunov.pro/api-wordpress/functions/wp_image_editor/), [`edit_form_image_editor`](https://chugunov.pro/api-wordpress/functions/edit_form_image_editor/), [`get_attachment_fields_to_edit`](https://chugunov.pro/api-wordpress/functions/get_attachment_fields_to_edit/), [`media_upload_form_handler`](https://chugunov.pro/api-wordpress/functions/media_upload_form_handler/), [`wp_check_post_lock`](https://chugunov.pro/api-wordpress/functions/wp_check_post_lock/), [`edit_post`](https://chugunov.pro/api-wordpress/functions/edit_post/).

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