apply_filters( 'wp_untrash_post_status', string $new_status, int $post_id, string $previous_status )

Filters the status that a post gets assigned when it is restored from the trash (untrashed).

Description Description

By default posts that are restored will be assigned a status of ‘draft’. Return the value of $previous_status in order to assign the status that the post had before it was trashed. The wp_untrash_post_set_previous_status() function is available for this.

Prior to WordPress 5.6.0, restored posts were always assigned their original status.

Top ↑

Parameters Parameters


(string) The new status of the post being restored.


(int) The ID of the post being restored.


(string) The status of the post at the point where it was trashed.

Top ↑

Source Source

File: wp-includes/post.php

View on Trac

Top ↑

Changelog Changelog

Version Description
5.6.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.