# wp_update_attachment_metadata()

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

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

## Сигнатура

```php
wp_update_attachment_metadata( int $attachment_id, array $data ): int|bool
```

## Описание

Обновляет метаданные вложения.

## Параметры

- `$attachment_id` `int` — обязательный. ID записи вложения.
- `$data` `array` — обязательный. Метаданные вложения.

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

`int|bool`

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

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

```php
function wp_update_attachment_metadata( $attachment_id, $data ) {
	$attachment_id = (int) $attachment_id;

	$post = get_post( $attachment_id );

	if ( ! $post ) {
		return false;
	}

	/**
	 * Filters the updated attachment meta data.
	 *
	 * @since 2.1.0
	 *
	 * @param array $data          Array of updated attachment meta data.
	 * @param int   $attachment_id Attachment post ID.
	 */
	$data = apply_filters( 'wp_update_attachment_metadata', $data, $post->ID );
	if ( $data ) {
		return update_post_meta( $post->ID, '_wp_attachment_metadata', $data );
	} else {
		return delete_post_meta( $post->ID, '_wp_attachment_metadata' );
	}
}
```

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

- 2.1.0 — Introduced.

## Связанные

Использует: [`update_post_meta`](https://chugunov.pro/api-wordpress/functions/update_post_meta/), [`delete_post_meta`](https://chugunov.pro/api-wordpress/functions/delete_post_meta/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: `WP_REST_Attachments_Controller::edit_media_item`, [`wp_update_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_update_image_subsizes/), [`wp_create_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_create_image_subsizes/), [`_wp_make_subsizes`](https://chugunov.pro/api-wordpress/functions/_wp_make_subsizes/), `WP_Customize_Manager::import_theme_starter_content`, `WP_REST_Attachments_Controller::create_item`, `WP_Site_Icon::insert_attachment`, [`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_generate_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_generate_attachment_metadata/), [`media_handle_upload`](https://chugunov.pro/api-wordpress/functions/media_handle_upload/), [`media_handle_sideload`](https://chugunov.pro/api-wordpress/functions/media_handle_sideload/), [`edit_post`](https://chugunov.pro/api-wordpress/functions/edit_post/), [`wp_ajax_save_attachment`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_attachment/), `Custom_Image_Header::insert_attachment`, `Custom_Image_Header::step_2`, `Custom_Background::handle_upload`, [`wp_maybe_generate_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_maybe_generate_attachment_metadata/), `wp_xmlrpc_server::mw_newMediaObject`.

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