WordPress at a glance
filter is not described

(type)_template_hierarchy filter-hook . WP 4.7.0

Filters the list of template filenames that are searched for when retrieving a template to use.

The last element in the array should always be the fallback template for this query type.

Possible values for $type include: 'index', '404', 'archive', 'author', 'category', 'tag', 'taxonomy', 'date', 'embed', 'home', 'frontpage', 'privacypolicy', 'page', 'paged', 'search', 'single', 'singular', and 'attachment'.


add_filter( '(type)_template_hierarchy', 'filter_function_name_171' );
function filter_function_name_171( $templates ){
	// filter...

	return $templates;
A list of template candidates, in descending order of priority.


Since 4.7.0 Introduced.

Where the hook is called

wp-includes/template.php 42
$templates = apply_filters( "{$type}_template_hierarchy", $templates );

Where in WP core the hook is used WordPress

Usage not found.