Title: WP_Customize_Manager::handle_changeset_trash_request
Published: November 20, 2017
Last modified: May 20, 2026

---

# WP_Customize_Manager::handle_changeset_trash_request()

## In this article

 * [Source](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#wp--skip-link--target)

Handles request to trash a changeset.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#source)󠁿

    ```php
    public function handle_changeset_trash_request() {
    	if ( ! is_user_logged_in() ) {
    		wp_send_json_error( 'unauthenticated' );
    	}

    	if ( ! $this->is_preview() ) {
    		wp_send_json_error( 'not_preview' );
    	}

    	if ( ! check_ajax_referer( 'trash_customize_changeset', 'nonce', false ) ) {
    		wp_send_json_error(
    			array(
    				'code'    => 'invalid_nonce',
    				'message' => __( 'There was an authentication problem. Please reload and try again.' ),
    			)
    		);
    	}

    	$changeset_post_id = $this->changeset_post_id();

    	if ( ! $changeset_post_id ) {
    		wp_send_json_error(
    			array(
    				'message' => __( 'No changes saved yet, so there is nothing to trash.' ),
    				'code'    => 'non_existent_changeset',
    			)
    		);
    		return;
    	}

    	if ( ! current_user_can( get_post_type_object( 'customize_changeset' )->cap->delete_post, $changeset_post_id ) ) {
    		wp_send_json_error(
    			array(
    				'code'    => 'changeset_trash_unauthorized',
    				'message' => __( 'Unable to trash changes.' ),
    			)
    		);
    	}

    	$lock_user = (int) wp_check_post_lock( $changeset_post_id );

    	if ( $lock_user && get_current_user_id() !== $lock_user ) {
    		wp_send_json_error(
    			array(
    				'code'     => 'changeset_locked',
    				'message'  => __( 'Changeset is being edited by other user.' ),
    				'lockUser' => $this->get_lock_user_data( $lock_user ),
    			)
    		);
    	}

    	if ( 'trash' === get_post_status( $changeset_post_id ) ) {
    		wp_send_json_error(
    			array(
    				'message' => __( 'Changes have already been trashed.' ),
    				'code'    => 'changeset_already_trashed',
    			)
    		);
    		return;
    	}

    	$r = $this->trash_changeset_post( $changeset_post_id );
    	if ( ! ( $r instanceof WP_Post ) ) {
    		wp_send_json_error(
    			array(
    				'code'    => 'changeset_trash_failure',
    				'message' => __( 'Unable to trash changes.' ),
    			)
    		);
    	}

    	wp_send_json_success(
    		array(
    			'message' => __( 'Changes trashed successfully.' ),
    		)
    	);
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-customize-manager.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/class-wp-customize-manager.php#L3139)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/class-wp-customize-manager.php#L3139-L3215)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_Customize_Manager::get_lock_user_data()](https://developer.wordpress.org/reference/classes/wp_customize_manager/get_lock_user_data/)`wp-includes/class-wp-customize-manager.php` |

Gets lock user data.

  | 
| [WP_Customize_Manager::trash_changeset_post()](https://developer.wordpress.org/reference/classes/wp_customize_manager/trash_changeset_post/)`wp-includes/class-wp-customize-manager.php` |

Trashes or deletes a changeset post.

  | 
| [WP_Customize_Manager::changeset_post_id()](https://developer.wordpress.org/reference/classes/wp_customize_manager/changeset_post_id/)`wp-includes/class-wp-customize-manager.php` |

Gets the changeset post ID for the loaded changeset.

  | 
| [wp_check_post_lock()](https://developer.wordpress.org/reference/functions/wp_check_post_lock/)`wp-admin/includes/post.php` |

Determines whether the post is currently being edited by another user.

  | 
| [WP_Customize_Manager::is_preview()](https://developer.wordpress.org/reference/classes/wp_customize_manager/is_preview/)`wp-includes/class-wp-customize-manager.php` |

Determines whether it is a theme preview or not.

  | 
| [get_post_status()](https://developer.wordpress.org/reference/functions/get_post_status/)`wp-includes/post.php` |

Retrieves the post status based on the post ID.

  | 
| [current_user_can()](https://developer.wordpress.org/reference/functions/current_user_can/)`wp-includes/capabilities.php` |

Returns whether the current user has the specified capability.

  | 
| [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [is_user_logged_in()](https://developer.wordpress.org/reference/functions/is_user_logged_in/)`wp-includes/pluggable.php` |

Determines whether the current visitor is a logged in user.

  | 
| [check_ajax_referer()](https://developer.wordpress.org/reference/functions/check_ajax_referer/)`wp-includes/pluggable.php` |

Verifies the Ajax request to prevent processing requests external of the blog.

  | 
| [wp_send_json_error()](https://developer.wordpress.org/reference/functions/wp_send_json_error/)`wp-includes/functions.php` |

Sends a JSON response back to an Ajax request, indicating failure.

  | 
| [wp_send_json_success()](https://developer.wordpress.org/reference/functions/wp_send_json_success/)`wp-includes/functions.php` |

Sends a JSON response back to an Ajax request, indicating success.

  | 
| [get_current_user_id()](https://developer.wordpress.org/reference/functions/get_current_user_id/)`wp-includes/user.php` |

Gets the current user’s ID.

  | 
| [get_post_type_object()](https://developer.wordpress.org/reference/functions/get_post_type_object/)`wp-includes/post.php` |

Retrieves a post type object by name.

  |

[Show 9 more](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_customize_manager/handle_changeset_trash_request/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.9.0](https://developer.wordpress.org/reference/since/4.9.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_customize_manager%2Fhandle_changeset_trash_request%2F)
before being able to contribute a note or feedback.