get_stylesheet_directory() – Function

Retrieves stylesheet directory path for the active theme.

Return

string Path to active theme’s stylesheet directory.

More Information

The returning path does not contain a trailing slash.
An example output of get_stylesheet_directory() is
/home/user/public_html/wp-content/themes/my_theme
In the event a child theme is being used, that is the directory that will be returned, not the parent theme directory (use get_template_directory() instead if you want the parent directory).
To retrieve the URI of the stylesheet directory use get_stylesheet_directory_uri()
To retrieve the path of a parent theme, use get_template_directory()

Source

function get_stylesheet_directory() {
	$stylesheet     = get_stylesheet();
	$theme_root     = get_theme_root( $stylesheet );
	$stylesheet_dir = "$theme_root/$stylesheet";

	/**
	 * Filters the stylesheet directory path for the active theme.
	 *
	 * @since 1.5.0
	 *
	 * @param string $stylesheet_dir Absolute path to the active theme.
	 * @param string $stylesheet     Directory name of the active theme.
	 * @param string $theme_root     Absolute path to themes directory.
	 */
	return apply_filters( 'stylesheet_directory', $stylesheet_dir, $stylesheet, $theme_root );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘stylesheet_directory’, string $stylesheet_dir, string $stylesheet, string $theme_root ): Filters the stylesheet directory path for the active theme.

Uses	Description
get_theme_root()`wp-includes/theme.php`	Retrieves path to themes directory.
get_stylesheet()`wp-includes/theme.php`	Retrieves name of the current stylesheet.
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_set_template_globals()`wp-includes/template.php`	Set up the globals used for template loading.
get_block_asset_url()`wp-includes/blocks.php`	Gets the URL to a block asset.
wp_theme_has_theme_json()`wp-includes/global-styles-and-settings.php`	Checks whether a theme or its parent has a theme.json file.
WP_Theme_JSON_Resolver::get_style_variations()`wp-includes/class-wp-theme-json-resolver.php`	Returns the style variations defined by the theme.
wp_generate_block_templates_export_file()`wp-includes/block-template-utils.php`	Creates an export of the current templates and template parts from the site editor at the specified path in a ZIP file.
_get_block_template_file()`wp-includes/block-template-utils.php`	Retrieves the template file from the theme for a given slug.
_get_block_templates_files()`wp-includes/block-template-utils.php`	Retrieves the template files from the theme.
WP_Theme_JSON_Resolver::get_file_path_from_theme()`wp-includes/class-wp-theme-json-resolver.php`	Builds the path to the given file and checks that it is readable.
locate_block_template()`wp-includes/block-template.php`	Finds a block template with equal or higher specificity than a given PHP template file.
resolve_block_template()`wp-includes/block-template.php`	Returns the correct ‘wp_template’ to render for the request template type.
WP_Debug_Data::debug_data()`wp-admin/includes/class-wp-debug-data.php`	Static function for generating site debug data when required.
WP_Customize_Manager::prepare_starter_content_attachments()`wp-includes/class-wp-customize-manager.php`	Prepares starter content attachments.
get_theme_file_path()`wp-includes/link-template.php`	Retrieves the path of a file in the theme.
get_theme_file_uri()`wp-includes/link-template.php`	Retrieves the URL of a file in the theme.
_load_textdomain_just_in_time()`wp-includes/l10n.php`	Loads plugin and theme text domains just-in-time.
get_editor_stylesheets()`wp-includes/theme.php`	Retrieves any registered editor stylesheet URLs.
validate_current_theme()`wp-includes/theme.php`	Checks that the active theme has the required files.
get_locale_stylesheet_uri()`wp-includes/theme.php`	Retrieves the localized stylesheet URI.
load_child_theme_textdomain()`wp-includes/l10n.php`	Loads the child theme’s translated strings.
wp_templating_constants()`wp-includes/default-constants.php`	Defines templating-related WordPress constants.

Show 15 more Show less

Changelog

Version	Description
6.4.2	Memoization removed.
6.4.0	Memoizes filter execution so that it only runs once for the current theme.
1.5.0	Introduced.

User Contributed Notes

Skip to note 4 content

Codex 9 years ago

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

Include a PHP file
```
<?php include( get_stylesheet_directory() . '/includes/myfile.php' ); ?>
```
Log in to add feedback
Skip to note 5 content

Andrew Schultz 4 years ago

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

You can also use the constant “STYLESHEETPATH” in replacement of get_stylesheet_directory()
- IMO it is preferable to use the function rather than the constant, because it includes additional logic that the constant cannot, most prominently the filter, which can allow you to conditionally change the theme on demand.
  
  crstauf 4 years ago
Log in to add feedback
Skip to note 6 content

Matthias Baier 8 years ago

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

get_stylesheet_directory() retrieves the child-theme’s directory.
If you want to retrieve the parent-theme’s directory use get_template_directory() instead or even better loacate_template() – This way WordPress automatically uses your child themes directory to look for your resource – if there is a child-theme-file present it will use this one instead. No need for enqueuing anything.

Log in to add feedback

get_stylesheet_directory(): string

In this article

Return

More Information

Source

Hooks

Changelog

User Contributed Notes

get_stylesheet_directory(): string

In this article

Return

More Information

Source

Hooks

Related

Changelog

User Contributed Notes