get_template_directory_uri() – Function

Retrieves template directory URI for the active theme.

Return

string URI to active theme’s template directory.

More Information

Notes

Checks for SSL
Does not return a trailing slash following the directory address

Source

function get_template_directory_uri() {
	$template         = str_replace( '%2F', '/', rawurlencode( get_template() ) );
	$theme_root_uri   = get_theme_root_uri( $template );
	$template_dir_uri = "$theme_root_uri/$template";

	/**
	 * Filters the active theme directory URI.
	 *
	 * @since 1.5.0
	 *
	 * @param string $template_dir_uri The URI of the active theme directory.
	 * @param string $template         Directory name of the active theme.
	 * @param string $theme_root_uri   The themes root URI.
	 */
	return apply_filters( 'template_directory_uri', $template_dir_uri, $template, $theme_root_uri );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘template_directory_uri’, string $template_dir_uri, string $template, string $theme_root_uri ): Filters the active theme directory URI.

Uses	Description
get_theme_root_uri()`wp-includes/theme.php`	Retrieves URI for themes directory.
get_template()`wp-includes/theme.php`	Retrieves name of the active theme.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Used by	Description
WP_REST_Themes_Controller::prepare_item_for_response()`wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php`	Prepares a single theme output for response.
get_parent_theme_file_uri()`wp-includes/link-template.php`	Retrieves the URL of a file in the parent theme.
get_theme_file_uri()`wp-includes/link-template.php`	Retrieves the URL of a file in the theme.
get_editor_stylesheets()`wp-includes/theme.php`	Retrieves any registered editor stylesheet URLs.
Custom_Image_Header::get_default_header_images()`wp-admin/includes/class-custom-image-header.php`	Gets the details of default header images if defined.
Custom_Image_Header::step_1()`wp-admin/includes/class-custom-image-header.php`	Displays first step of custom header image page.
Custom_Image_Header::reset_header_image()`wp-admin/includes/class-custom-image-header.php`	Resets a header image to the default image for the theme.
Custom_Image_Header::process_default_headers()`wp-admin/includes/class-custom-image-header.php`	Processes the default headers.
WP_Customize_Manager::register_controls()`wp-includes/class-wp-customize-manager.php`	Registers some default controls.
_get_random_header_data()`wp-includes/theme.php`	Gets random header image data from registered images in theme.
get_custom_header()`wp-includes/theme.php`	Gets the header image data.
get_theme_mod()`wp-includes/theme.php`	Retrieves theme modification value for the active theme.
get_bloginfo()`wp-includes/general-template.php`	Retrieves information about the current site.

Show 8 more Show less

Changelog

Version	Description
1.5.0	Introduced.

User Contributed Notes

Skip to note 6 content

Florian Simeth 8 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 44You must log in to vote on the helpfulness of this note

This function returns the URL to the root theme. If a child theme is used and you want to return the URL to the current child theme, use get_stylesheet_directory_uri() instead.

Log in to add feedback
Skip to note 7 content

Debabrata Ghosh 8 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 16You must log in to vote on the helpfulness of this note
Using get_template_directory_uri() to link a static image with its correct path in html :
```
<img src="<?php echo get_template_directory_uri(); ?>/images/logo.png" width="" height="" alt="" />
```
Log in to add feedback
Skip to note 8 content

Carlos Longarela 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 10You must log in to vote on the helpfulness of this note

Since WordPress 4.7.0 you can use get_theme_file_uri() https://developer.wordpress.org/reference/functions/get_theme_file_uri/ and this function will give us actual child theme URL or Theme URL if no child Theme exists.

Log in to add feedback
Skip to note 9 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note
Using get_template_directory_uri() to enqueue a script with the correct path.
```
add_action('wp_enqueue_scripts', 'wpdocs_scripts_method');

/*
 * Enqueue a script with the correct path.
 */
function wpdocs_scripts_method() {
	wp_enqueue_script(
		'custom_script',
		get_template_directory_uri() . '/js/custom_script.js',
		array('jquery')
	);
}
```
Log in to add feedback

Emil Uzelac 9 years ago

/**
 * Enqueue scripts and styles.
 */
function wpdocs_theme_slug_scripts() {
	// Custom scripts require a unique slug (Theme Name).
	wp_enqueue_script( 'theme-slug-custom-script', get_template_directory_uri() . '/js/custom-script.js', array(), '1.0.0', true );

	/*
	 * To avoid double loading Genericons will not need a slug. Same applies
	 * to all other non-custom styles or scripts.
	 */
	wp_enqueue_style( 'genericons', get_template_directory_uri() . '/genericons/genericons.css', array(), '1.0.0' );
}
add_action( 'wp_enqueue_scripts', 'wpdocs_theme_slug_scripts' );

get_template_directory_uri(): string

In this article

Return

More Information

Notes

Source

Hooks

Changelog

User Contributed Notes