# add_post_meta()

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

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

## Сигнатура

```php
add_post_meta( int $post_id, string $meta_key, mixed $meta_value, bool $unique = false ): int|false
```

## Описание

Метаданные записи называются «Произвольными полями» на экране администрирования.
По историческим причинам и ключ метаданных, и значение метаданных на входе ожидаются «со слэшами» (с экранированными слэшами).

## Параметры

- `$post_id` `int` — обязательный. Идентификатор записи.
- `$meta_key` `string` — обязательный. Имя метаданных.
- `$meta_value` `mixed` — обязательный. Значение метаданных. Массивы и объекты сохраняются как сериализованные данные и возвращаются того же типа при получении. Остальные типы данных сохраняются в базе данных как строки:
  
  false сохраняется и возвращается как пустая строка ('')
  
  true сохраняется и возвращается как '1'
  
  числа (как целые, так и с плавающей точкой) сохраняются и возвращаются как строки. Должно быть сериализуемым, если не является скалярным значением.
- `$unique` `bool` — необязательный, по умолчанию `false`. Следует ли запретить добавление одного и того же ключа.

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

`int|false`

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

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

```php
function add_post_meta( $post_id, $meta_key, $meta_value, $unique = false ) {
	// Make sure meta is added to the post, not a revision.
	$the_post = wp_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}

	return add_metadata( 'post', $post_id, $meta_key, $meta_value, $unique );
}
```

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

- 1.5.0 — Introduced.

## Связанные

Использует: [`wp_is_post_revision`](https://chugunov.pro/api-wordpress/functions/wp_is_post_revision/), [`add_metadata`](https://chugunov.pro/api-wordpress/functions/add_metadata/).
Используется в: `WP_REST_Font_Faces_Controller::create_item`, [`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::_policy_page_updated`, `WP_Customize_Manager::trash_changeset_post`, [`wp_add_trashed_suffix_to_post_name_for_post`](https://chugunov.pro/api-wordpress/functions/wp_add_trashed_suffix_to_post_name_for_post/), [`wp_generate_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_generate_attachment_metadata/), [`media_sideload_image`](https://chugunov.pro/api-wordpress/functions/media_sideload_image/), [`wp_write_post`](https://chugunov.pro/api-wordpress/functions/wp_write_post/), [`add_meta`](https://chugunov.pro/api-wordpress/functions/add_meta/), [`do_enclose`](https://chugunov.pro/api-wordpress/functions/do_enclose/), [`_publish_post_hook`](https://chugunov.pro/api-wordpress/functions/_publish_post_hook/), [`wp_check_for_changed_slugs`](https://chugunov.pro/api-wordpress/functions/wp_check_for_changed_slugs/), [`wp_insert_post`](https://chugunov.pro/api-wordpress/functions/wp_insert_post/), [`wp_trash_post`](https://chugunov.pro/api-wordpress/functions/wp_trash_post/), [`wp_trash_post_comments`](https://chugunov.pro/api-wordpress/functions/wp_trash_post_comments/), `wp_xmlrpc_server::add_enclosure_if_new`, `wp_xmlrpc_server::set_custom_fields`.

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