WordPress at a glance
function is not described

get_taxonomy_template() WP 2.5.0

Retrieve path of custom taxonomy term template in current or parent template.

The hierarchy for this template looks like:

  1. taxonomy-{taxonomy_slug}-{term_slug}.php
  2. taxonomy-{taxonomy_slug}.php
  3. taxonomy.php

An example of this is:

  1. taxonomy-location-texas.php
  2. taxonomy-location.php
  3. taxonomy.php

The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'} and {@see '$type_template'} dynamic hooks, where $type is 'taxonomy'.

  • See: get_query_template()
  • Since 4.7.0 The decoded form of taxonomy-{taxonomy_slug}-{term_slug}.php was added to the top of the template hierarchy when the term slug contains multibyte characters.

No Hooks.


String. Full path to custom taxonomy term template file.



Code of get taxonomy template: wp-includes/template.php WP 5.2.2

function get_taxonomy_template() {
	$term = get_queried_object();

	$templates = array();

	if ( ! empty( $term->slug ) ) {
		$taxonomy = $term->taxonomy;

		$slug_decoded = urldecode( $term->slug );
		if ( $slug_decoded !== $term->slug ) {
			$templates[] = "taxonomy-$taxonomy-{$slug_decoded}.php";

		$templates[] = "taxonomy-$taxonomy-{$term->slug}.php";
		$templates[] = "taxonomy-$taxonomy.php";
	$templates[] = 'taxonomy.php';

	return get_query_template( 'taxonomy', $templates );