wp_update_attachment_metadata( int $attachment_id, array $data )

Update metadata for an attachment.

Parameters

$attachment_id

(Required) Attachment post ID.

$data

(Required) Attachment meta data.

Return

(int|bool) False if $post is invalid.

Source

File: wp-includes/post.php 

function wp_update_attachment_metadata( $attachment_id, $data ) {
	$attachment_id = (int) $attachment_id;
	if ( ! $post = get_post( $attachment_id ) ) {
		return false;
	}

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

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.
wp-includes/post.php: wp_update_attachment_metadata

Filters the updated attachment meta data.
wp-includes/post.php: update_post_meta()

Update post meta field based on post ID.
wp-includes/post.php: delete_post_meta()

Remove metadata matching criteria from a post.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.

Used By

Used By
Used By Description
wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php: WP_REST_Attachments_Controller::create_item()

Creates a single attachment.
wp-includes/media.php: wp_maybe_generate_attachment_metadata()

Maybe attempts to generate attachment metadata, if missing.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_newMediaObject()

Uploads a file, following your settings.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::import_theme_starter_content()

Import theme starter content into the customized state.
wp-admin/custom-background.php: Custom_Background::handle_upload()

Handle an Image upload for the background image.
wp-admin/custom-header.php: Custom_Image_Header::insert_attachment()

Insert an attachment and its metadata.
wp-admin/custom-header.php: Custom_Image_Header::step_2()

Display second step of custom header image page.
wp-admin/includes/class-wp-site-icon.php: WP_Site_Icon::insert_attachment()

Inserts an attachment.
wp-admin/includes/image.php: wp_generate_attachment_metadata()

Generate post thumbnail attachment meta data.
wp-admin/includes/media.php: media_handle_upload()

Save a file submitted from a POST request and create an attachment post for it.
wp-admin/includes/media.php: media_handle_sideload()

Handles a side-loaded file in the same way as an uploaded file is handled by media_handle_upload().
wp-admin/includes/image-edit.php: wp_save_image()

Saves image to post along with enqueued changes in $_REQUEST[‘history’]
wp-admin/includes/image-edit.php: wp_restore_image()

Restores the metadata for a given attachment.
wp-admin/includes/ajax-actions.php: wp_ajax_crop_image()

Ajax handler for cropping an image.
wp-admin/includes/ajax-actions.php: wp_ajax_save_attachment()

Ajax handler for updating attachment attributes.
wp-admin/includes/post.php: edit_post()

Update an existing post with values provided in $_POST.
Show 11 more used by Hide more used by

Changelog

Changelog
Version Description
WP-2.1.0 Introduced.