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

Returns a post array ready to be inserted into the posts table as a post revision.

Syntax Syntax

_wp_post_revision_data( array|WP_Post $post = array(), bool $autosave = false )

Parameters Parameters


(Optional) A post array or a WP_Post object to be processed for insertion as a post revision.

Default value: array()


(Optional) Is the revision an autosave?

Default value: false

Return Return

(array) Post array ready to be inserted as a post revision.

Source Source

File: wp-includes/revision.php

		$post = get_post( $post, ARRAY_A );

	$fields = _wp_post_revision_fields( $post );

	$revision_data = array();

	foreach ( array_intersect( array_keys( $post ), array_keys( $fields ) ) as $field ) {
		$revision_data[ $field ] = $post[ $field ];

	$revision_data['post_parent']   = $post['ID'];
	$revision_data['post_status']   = 'inherit';
	$revision_data['post_type']     = 'revision';
	$revision_data['post_name']     = $autosave ? "$post[ID]-autosave-v1" : "$post[ID]-revision-v1"; // "1" is the revisioning system version.
	$revision_data['post_date']     = isset( $post['post_modified'] ) ? $post['post_modified'] : '';
	$revision_data['post_date_gmt'] = isset( $post['post_modified_gmt'] ) ? $post['post_modified_gmt'] : '';

	return $revision_data;



Changelog Changelog

Version Description
4.5.0 Introduced.


Leave a Reply