remove_action( string $tag, callable $function_to_remove, int $priority = 10 )

Removes a function from a specified action hook.


This function removes a function attached to a specified action hook. This method can be used to remove default functions attached to a specific filter hook and possibly replace them with a substitute.



(string) (Required) The action hook to which the function to be removed is hooked.


(callable) (Required) The name of the function which should be removed.


(int) (Optional) The priority of the function.

Default value: 10


(bool) Whether the function is removed.

More Information

  • This function is an alias to remove_filter().
  • See also add_action() and add_filter().
  • To remove a hook, the $function_to_remove and $priority arguments must match when the hook was added. This goes for both filters and actions. No warning will be given on removal failure.


File: wp-includes/plugin.php

function remove_action( $tag, $function_to_remove, $priority = 10 ) {
	return remove_filter( $tag, $function_to_remove, $priority );


Version Description
1.2.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.