apply_filters_deprecated( string $tag, array $args, string $version, string $replacement = false, string $message = null )

Fires functions attached to a deprecated filter hook.

Description Description

When a filter hook is deprecated, the apply_filters() call is replaced with apply_filters_deprecated(), which triggers a deprecation notice and then fires the original filter hook.

Parameters Parameters


(string) (Required) The name of the filter hook.


(array) (Required) Array of additional function arguments to be passed to apply_filters().


(string) (Required) The version of WordPress that deprecated the hook.


(string) (Optional) The hook that should have been used.

Default value: false


(string) (Optional) A message regarding the change.

Default value: null

Top ↑

Source Source

File: wp-includes/plugin.php

function apply_filters_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {
	if ( ! has_filter( $tag ) ) {
		return $args[0];

	_deprecated_hook( $tag, $version, $replacement, $message );

	return apply_filters_ref_array( $tag, $args );

Top ↑

Changelog Changelog

Version Description
4.6.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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