unregister_post_type() │ WP 4.5.0

Cancels the registration of the specified post type. Deletes the post type.

Does not work with built-in post types: posts, pages, attachments, etc., i.e., those that have the _builtin parameter specified during registration using register_post_type.

When deleting a post type, everything associated with it is removed: query parameters, permalink rules, etc.

To unregister a taxonomy, use unregister_taxonomy().

Hooks from the function

Returns

true|WP_Error.

  • True, on successful cancellation.
  • WP_Error, on unsuccessful cancellation or when the specified post type does not exist.

Usage

unregister_post_type( $post_type );
$post_type(string) (required)
The name of the post type to unregister.

Examples

0

#1 Unregister a post type

Suppose that some plugin or theme registers post type product, and we don't need it:

// All post types are registered during ``init`` action,
// so you should unregister them after it.
// Use for that ``wp_loaded`` action or ``init`` but with lower priority.

add_action('init', 'my_unregister_post_type', 999);
function my_unregister_post_type(){
	unregister_post_type('product');
}

Notes

  • Global. Array. $wp_post_types List of post types.

Changelog

Since 4.5.0 Introduced.

unregister_post_type() code WP 6.9

wp-includes/post.php 
function unregister_post_type( $post_type ) {
	global $wp_post_types;

	if ( ! post_type_exists( $post_type ) ) {
		return new WP_Error( 'invalid_post_type', __( 'Invalid post type.' ) );
	}

	$post_type_object = get_post_type_object( $post_type );

	// Do not allow unregistering internal post types.
	if ( $post_type_object->_builtin ) {
		return new WP_Error( 'invalid_post_type', __( 'Unregistering a built-in post type is not allowed' ) );
	}

	$post_type_object->remove_supports();
	$post_type_object->remove_rewrite_rules();
	$post_type_object->unregister_meta_boxes();
	$post_type_object->remove_hooks();
	$post_type_object->unregister_taxonomies();

	unset( $wp_post_types[ $post_type ] );

	/**
	 * Fires after a post type was unregistered.
	 *
	 * @since 4.5.0
	 *
	 * @param string $post_type Post type key.
	 */
	do_action( 'unregistered_post_type', $post_type );

	return true;
}

Custom post type (post_type)

Custom Types