# update_post_meta()

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

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

## Сигнатура

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

## Описание

Используйте параметр $prev_value, чтобы различать метаполя с одинаковым ключом и ID записи.
Если метаполе для записи не существует, оно будет добавлено, а его ID возвращён.
Может использоваться вместо add_post_meta().
По историческим причинам и ключ метаданных, и значение метаданных на входе ожидаются «со слэшами» (с экранированными слэшами).

## Параметры

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

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

`int|bool`

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

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

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

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

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

- 1.5.0 — Introduced.

## Связанные

Использует: [`wp_is_post_revision`](https://chugunov.pro/api-wordpress/functions/wp_is_post_revision/), [`update_metadata`](https://chugunov.pro/api-wordpress/functions/update_metadata/).
Используется в: `WP_REST_Attachments_Controller::edit_media_item`, `WP_REST_Attachments_Controller::insert_attachment`, [`_wp_privacy_account_request_confirmed`](https://chugunov.pro/api-wordpress/functions/_wp_privacy_account_request_confirmed/), [`_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_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_completed_request`](https://chugunov.pro/api-wordpress/functions/_wp_privacy_completed_request/), `WP_Customize_Manager::set_changeset_lock`, `WP_Customize_Manager::refresh_changeset_lock`, `WP_Customize_Manager::dismiss_user_auto_draft_changesets`, `WP_Customize_Manager::import_theme_starter_content`, `WP_REST_Attachments_Controller::create_item`, `WP_REST_Attachments_Controller::update_item`, `WP_REST_Posts_Controller::handle_template`, `Custom_Background::ajax_background_add`, [`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_generate_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_generate_attachment_metadata/), [`media_upload_form_handler`](https://chugunov.pro/api-wordpress/functions/media_upload_form_handler/), [`media_handle_upload`](https://chugunov.pro/api-wordpress/functions/media_handle_upload/), [`media_handle_sideload`](https://chugunov.pro/api-wordpress/functions/media_handle_sideload/), [`wp_set_post_lock`](https://chugunov.pro/api-wordpress/functions/wp_set_post_lock/), [`edit_post`](https://chugunov.pro/api-wordpress/functions/edit_post/), [`bulk_edit_posts`](https://chugunov.pro/api-wordpress/functions/bulk_edit_posts/), [`wp_ajax_upload_attachment`](https://chugunov.pro/api-wordpress/functions/wp_ajax_upload_attachment/), [`wp_ajax_wp_remove_post_lock`](https://chugunov.pro/api-wordpress/functions/wp_ajax_wp_remove_post_lock/), [`wp_ajax_save_attachment`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_attachment/), `Custom_Image_Header::ajax_header_add`, `Custom_Image_Header::customize_set_last_used`, `Custom_Image_Header::set_header_image`, `Custom_Background::wp_set_background_image`, `Custom_Background::handle_upload`, `WP_Embed::shortcode`, [`do_shortcode`](https://chugunov.pro/api-wordpress/functions/do_shortcode/), [`set_post_thumbnail`](https://chugunov.pro/api-wordpress/functions/set_post_thumbnail/), [`wp_update_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_update_attachment_metadata/), [`wp_insert_post`](https://chugunov.pro/api-wordpress/functions/wp_insert_post/), [`update_attached_file`](https://chugunov.pro/api-wordpress/functions/update_attached_file/), [`wp_restore_post_revision`](https://chugunov.pro/api-wordpress/functions/wp_restore_post_revision/).

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