has_action( string $hook_name, callable|string|array|false $callback = false ): bool|int

Checks if any action has been registered for a hook.


When using the $callback argument, this function may return a non-boolean value that evaluates to false (e.g. 0), so use the === operator for testing the return value.

Top ↑

See also

Top ↑


$hook_name string Required
The name of the action hook.
$callback callable|string|array|false Optional
The callback to check for.
This function can be called unconditionally to speculatively check a callback that may or may not exist.

Default: false

Top ↑


bool|int If $callback is omitted, returns boolean for whether the hook has anything registered. When checking a specific function, the priority of that hook is returned, or false if the function is not attached.

Top ↑

More Information

Since this action is an alias of has_filter() , it also uses the global array $wp_filter that stores all of the filters / actions.

Top ↑


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

function has_action( $hook_name, $callback = false ) {
	return has_filter( $hook_name, $callback );

Top ↑


Version Description
2.5.0 Introduced.

Top ↑

User Contributed Notes

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