Private Access Private Access

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Summery Summery

Updates the attached file and image meta data when the original image was edited.

Syntax Syntax

_wp_image_meta_replace_original( array $saved_data, string $original_file, array $image_meta, int $attachment_id )

Parameters Parameters


(Required) The data returned from WP_Image_Editor after successfully saving an image.


(Required) Path to the original file.


(Required) The image meta data.


(Required) The attachment post ID.

Return Return

(array) The updated image meta data.

Source Source

File: wp-admin/includes/image.php

function _wp_image_meta_replace_original( $saved_data, $original_file, $image_meta, $attachment_id ) {
	$new_file = $saved_data['path'];

	// Update the attached file meta.
	update_attached_file( $attachment_id, $new_file );

	// Width and height of the new image.
	$image_meta['width']  = $saved_data['width'];
	$image_meta['height'] = $saved_data['height'];

	// Make the file path relative to the upload dir.
	$image_meta['file'] = _wp_relative_upload_path( $new_file );

	// Store the original image file name in image_meta.
	$image_meta['original_image'] = wp_basename( $original_file );

	return $image_meta;


Changelog Changelog

Version Description
5.3.0 Introduced.


Leave a Reply