doing_filter( null|string $filter = null )

Retrieve the name of a filter currently being processed.

Description Description

The function current_filter() only returns the most recent filter or action being executed. did_action() returns true once the action is initially processed.

This function allows detection for any filter currently being executed (despite not being the most recent filter to fire, in the case of hooks called from hook callbacks) to be verified.

See also See also

Top ↑

Parameters Parameters


(null|string) (Optional) Filter to check. Defaults to null, which checks if any filter is currently being run.

Default value: null

Top ↑

Return Return

(bool) Whether the filter is currently in the stack.

Top ↑

Source Source

File: wp-includes/plugin.php

function doing_filter( $filter = null ) {
	global $wp_current_filter;

	if ( null === $filter ) {
		return ! empty( $wp_current_filter );

	return in_array( $filter, $wp_current_filter );

Top ↑

Changelog Changelog

Version Description
3.9.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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