# _wp_copy_post_meta()

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

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

## Сигнатура

```php
_wp_copy_post_meta( int $source_post_id, int $target_post_id, string $meta_key )
```

## Описание

Копирует метаданные записи по заданному ключу из одной записи в другую.

## Параметры

- `$source_post_id` `int` — обязательный. Идентификатор записи, из которой копируются значения метаданных.
- `$target_post_id` `int` — обязательный. Идентификатор записи, в которую копируются значения метаданных.
- `$meta_key` `string` — обязательный. Ключ метаданных для копирования.

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

Файл: `wp-includes/revision.php:541`

```php
function _wp_copy_post_meta( $source_post_id, $target_post_id, $meta_key ) {

	foreach ( get_post_meta( $source_post_id, $meta_key ) as $meta_value ) {
		/**
		 * We use add_metadata() function vs add_post_meta() here
		 * to allow for a revision post target OR regular post.
		 */
		add_metadata( 'post', $target_post_id, $meta_key, wp_slash( $meta_value ) );
	}
}
```

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

- 6.4.0 — Introduced.

## Связанные

Использует: [`add_metadata`](https://chugunov.pro/api-wordpress/functions/add_metadata/), [`wp_slash`](https://chugunov.pro/api-wordpress/functions/wp_slash/), [`get_post_meta`](https://chugunov.pro/api-wordpress/functions/get_post_meta/).
Используется в: [`wp_restore_post_revision_meta`](https://chugunov.pro/api-wordpress/functions/wp_restore_post_revision_meta/), [`wp_save_revisioned_meta_fields`](https://chugunov.pro/api-wordpress/functions/wp_save_revisioned_meta_fields/).

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