WP_Hook::remove_filter( string $tag, callable $function_to_remove, int $priority )

Unhooks a function or method from a specific filter action.

Description Description

Parameters Parameters


(string) (Required) The filter hook to which the function to be removed is hooked. Used for building the callback ID when SPL is not available.


(callable) (Required) The callback to be removed from running when the filter is applied.


(int) (Required) The exact priority used when adding the original filter callback.

Top ↑

Return Return

(bool) Whether the callback existed before it was removed.

Top ↑

Source Source

File: wp-includes/class-wp-hook.php

	public function remove_filter( $tag, $function_to_remove, $priority ) {
		$function_key = _wp_filter_build_unique_id( $tag, $function_to_remove, $priority );

		$exists = isset( $this->callbacks[ $priority ][ $function_key ] );
		if ( $exists ) {
			unset( $this->callbacks[ $priority ][ $function_key ] );
			if ( ! $this->callbacks[ $priority ] ) {
				unset( $this->callbacks[ $priority ] );
				if ( $this->nesting_level > 0 ) {
		return $exists;

Top ↑

Changelog Changelog

Version Description
4.7.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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