get_stylesheet_directory_uri(): string
Retrieves stylesheet directory URI for the active theme.
Return
string URI to active theme's stylesheet directory.
More Information
- The returned URI does not contain a trailing slash.
- This function returns a properly-formed URI; in other words, it will be a web-address (starting with http:// or https:// for SSL). As such, it is most appropriately used for links, referencing additional stylesheets, or probably most commonly, images.
- In the event a child theme is being used, this function will return the child’s theme directory URI. Use get_template_directory_uri() to avoid being overridden by a child theme.
- If you want to include a local file in PHP, use get_stylesheet_directory() instead.
Source
File: wp-includes/theme.php
.
View all references
function get_stylesheet_directory_uri() {
$stylesheet = str_replace( '%2F', '/', rawurlencode( get_stylesheet() ) );
$theme_root_uri = get_theme_root_uri( $stylesheet );
$stylesheet_dir_uri = "$theme_root_uri/$stylesheet";
/**
* Filters the stylesheet directory URI.
*
* @since 1.5.0
*
* @param string $stylesheet_dir_uri Stylesheet directory URI.
* @param string $stylesheet Name of the activated theme's directory.
* @param string $theme_root_uri Themes root URI.
*/
return apply_filters( 'stylesheet_directory_uri', $stylesheet_dir_uri, $stylesheet, $theme_root_uri );
}
Hooks
-
apply_filters( 'stylesheet_directory_uri',
string $stylesheet_dir_uri ,string $stylesheet ,string $theme_root_uri ) -
Filters the stylesheet directory URI.
Changelog
Version | Description |
---|---|
1.5.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
This function returns the URL to the current child theme if a child theme is used. If you want to return the URL to the root/mother theme, use get_template_directory_uri() instead.
Image (HTML)
Given –
Website URL:
https://example.com/
Active theme folder:
mytheme
This function returns the following string:
https://example.com/wp-content/themes/mytheme
NOTE: without trailing slash (/)
When using inside HTML `src` attribute, you should escape the returned URL when you add some files after the function: