do_action( 'wp_trash_post', int $post_id, string $previous_status )

Fires before a post is sent to the Trash.


$post_id int
Post ID.
$previous_status string
The status of the post about to be trashed.

Top ↑


File: wp-includes/post.php. View all references

do_action( 'wp_trash_post', $post_id, $previous_status );

Top ↑


Version Description
6.3.0 Added the $previous_status parameter.
3.3.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Riverlab

    To get the id of all posts that have been trashed when selecting multiples, you must use the


    Like that example below:

    function wpdocs_trash_multiple_posts( $post_id = '' ) {
        // Verify if is trashing multiple posts
        if ( isset( $_GET['post'] ) && is_array( $_GET['post'] ) ) {
            foreach ( $_GET['post'] as $post_id ) {
                wpdocs_your_function( $post_id );
        } else {
            wpdocs_your_function( $post_id );
    add_action( 'wp_trash_post', 'wpdocs_trash_multiple_posts' );

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