get_theme_root_uri() │ WP 1.5.0

Gets the URL of the themes directory. The URL does not have a trailing slash.

This function is a wrapper for the construct content_url( 'themes' ).

Uses the global variable $wp_theme_directories.

To get the absolute path to the themes folder use get_theme_root()

Uses: content_url()
Used By: get_stylesheet_directory_uri(), get_template_directory_uri()
1 time — 0.00004 sec (very fast) | 50000 times — 2.11 sec (fast)
Hooks from the function

Returns

String. URL to the template directory.

Usage

get_theme_root_uri( $stylesheet_or_template, $theme_root );
$stylesheet_or_template(string)
The name of the theme for which the URL needs to be obtained.
Default: ''
$theme_root(string)

The path to the theme root that will be used in the URL definition. Replaces the call to the function get_raw_theme_root().

Example values:

'/themes'

$theme_root = get_option( 'stylesheet_root' );

$theme_root = get_option( 'template_root' );

$theme_roots = get_theme_roots();
$theme_root = $theme_roots[ $stylesheet_or_template ];

Default: ''

Examples

1

#1 An example of how the function works 

$themes_directory = get_theme_root_uri();
echo $themes_directory;

// display:
// https://example.com/wp-content/themes

Notes

  • Global. String[]. $wp_theme_directories

Changelog

Since 1.5.0 Introduced.

get_theme_root_uri() code WP 7.0

wp-includes/theme.php 
function get_theme_root_uri( $stylesheet_or_template = '', $theme_root = '' ) {
	global $wp_theme_directories;

	if ( $stylesheet_or_template && ! $theme_root ) {
		$theme_root = get_raw_theme_root( $stylesheet_or_template );
	}

	if ( $stylesheet_or_template && $theme_root ) {
		if ( in_array( $theme_root, (array) $wp_theme_directories, true ) ) {
			// Absolute path. Make an educated guess. YMMV -- but note the filter below.
			if ( str_starts_with( $theme_root, WP_CONTENT_DIR ) ) {
				$theme_root_uri = content_url( str_replace( WP_CONTENT_DIR, '', $theme_root ) );
			} elseif ( str_starts_with( $theme_root, ABSPATH ) ) {
				$theme_root_uri = site_url( str_replace( ABSPATH, '', $theme_root ) );
			} elseif ( str_starts_with( $theme_root, WP_PLUGIN_DIR ) || str_starts_with( $theme_root, WPMU_PLUGIN_DIR ) ) {
				$theme_root_uri = plugins_url( basename( $theme_root ), $theme_root );
			} else {
				$theme_root_uri = $theme_root;
			}
		} else {
			$theme_root_uri = content_url( $theme_root );
		}
	} else {
		$theme_root_uri = content_url( 'themes' );
	}

	/**
	 * Filters the URI for themes directory.
	 *
	 * @since 1.5.0
	 *
	 * @param string $theme_root_uri         The URI for themes directory.
	 * @param string $siteurl                WordPress web address which is set in General Options.
	 * @param string $stylesheet_or_template The stylesheet or template name of the theme.
	 */
	return apply_filters( 'theme_root_uri', $theme_root_uri, get_option( 'siteurl' ), $stylesheet_or_template );
}

theme path (theme folder url)

Link (URL)

Theme files connection