WordPress at Your Fingertips
action is not described

(new_status)_(post_type) action-hook . WP 2.3.0

Fires when a post is transitioned from one status to another.

The dynamic portions of the hook name, $new_status and $post->post_type, refer to the new post status and post type, respectively.

Possible hook names include:

  • draft_post
  • future_post
  • pending_post
  • private_post
  • publish_post
  • trash_post
  • draft_page
  • future_page
  • pending_page
  • private_page
  • publish_page
  • trash_page
  • publish_attachment
  • trash_attachment

Please note: When this action is hooked using a particular post status (like 'publish', as publish_{$post->post_type}), it will fire both when a post is first transitioned to that status from something else, as well as upon subsequent post updates (old and new status are both the same).

Therefore, if you are looking to only fire a callback when a post is first transitioned to a status, use the transition_post_status hook instead.


add_action( '(new_status)_(post_type)', 'action_function_name_989', 10, 2 );
function action_function_name_989( $post_id, $post ){
	// action...
Post ID.
Post object.


Since 2.3.0 Introduced.

Where the hook is called

wp-includes/post.php 5148
do_action( "{$new_status}_{$post->post_type}", $post->ID, $post );

Where in WP core the hook is used WordPress

Usage not found.