wp_enqueue_style() WordPress Function

The wp_enqueue_style function is used to load a CSS file into a WordPress site. This function should be used in the theme's functions.php file. The first parameter is the handle, or name, of the CSS file. The second parameter is the URL of the CSS file. The third parameter is an array of dependencies, or files that the CSS file depends on. The fourth parameter is the version number of the CSS file. The fifth parameter is the media type, or the type of device that the CSS file will be used on.

wp_enqueue_style( string $handle, string $src = '', string[] $deps = array(), string|bool|null $ver = false, string $media = 'all' ) #

Enqueue a CSS stylesheet.

Contents

Description

Registers the style if source provided (does NOT overwrite) and enqueues.

Top ↑

See also

Top ↑

Parameters

$handle

(string)(Required)Name of the stylesheet. Should be unique.

$src

(string)(Optional)Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory.

Default value: ''

$deps

(string[])(Optional) An array of registered stylesheet handles this stylesheet depends on.

Default value: array()

$ver

(string|bool|null)(Optional) String specifying stylesheet version number, if it has one, which is added to the URL as a query string for cache busting purposes. If version is set to false, a version number is automatically added equal to current installed WordPress version. If set to null, no version is added.

Default value: false

$media

(string)(Optional) The media for which this stylesheet has been defined. Accepts media types like 'all', 'print' and 'screen', or media queries like '(orientation: portrait)' and '(max-width: 640px)'.

Default value: 'all'

Top ↑

More Information

Top ↑

Usage

A safe way to add/enqueue a stylesheet file to the WordPress generated page.

wp_enqueue_style( $handle, $src, $deps, $ver, $media );

Top ↑

Notes

  • If you are going to use some jQuery UI features you might have to provide your own CSS file: WordPress core does not have a full jQuery UI theme!
  • Default styles that are loaded via WordPress Core can be discerned via the source code on the default styles page.

Top ↑

Source

File: wp-includes/functions.wp-styles.php

function wp_enqueue_style( $handle, $src = '', $deps = array(), $ver = false, $media = 'all' ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );

	$wp_styles = wp_styles();

	if ( $src ) {
		$_handle = explode( '?', $handle );
		$wp_styles->add( $_handle[0], $src, $deps, $ver, $media );
	}

	$wp_styles->enqueue( $handle );
}

Expand full source codeCollapse full source codeView on TracView on GitHub

Top ↑

Top ↑

Uses

Uses
UsesDescription
wp-includes/functions.wp-styles.php:wp_styles()

Initialize $wp_styles if it has not been set.

Top ↑

Used By

Used By
Used ByDescription
wp-includes/script-loader.php:_wp_theme_json_webfonts_handler()

Runs the theme.json webfonts handler.

wp-includes/script-loader.php:wp_enqueue_global_styles_css_custom_properties()

Function that enqueues the CSS Custom Properties coming from theme.json.

wp-includes/script-loader.php:wp_enqueue_block_style()

Enqueues a stylesheet for a specific block.

wp-includes/script-loader.php:wp_enqueue_editor_format_library_assets()

Enqueues the assets required for the format library within the block editor.

wp-includes/script-loader.php:wp_enqueue_global_styles()

Enqueues the global styles defined via theme.json.

wp-includes/class-wp-block.php:WP_Block::render()

Generates the render output for the block.

wp-includes/script-loader.php:wp_enqueue_editor_block_directory_assets()

Enqueues the assets required for the block directory within the block editor.

wp-includes/script-loader.php:enqueue_block_styles_assets()

Function responsible for enqueuing the styles required for block styles functionality on the editor and on the frontend.

wp-includes/script-loader.php:wp_common_block_scripts_and_styles()

Handles the enqueueing of block scripts and styles that are common to both the editor and the front-end.

wp-includes/script-loader.php:wp_enqueue_registered_block_scripts_and_styles()

Enqueues registered block scripts and styles, depending on current rendered context (only enqueuing editor scripts while in context of the editor).

wp-admin/includes/meta-boxes.php:register_and_do_post_meta_boxes()

Registers the default post meta boxes, and runs the do_meta_boxes actions.

wp-includes/general-template.php:wp_enqueue_code_editor()

Enqueue assets needed by the code editor for the given settings.

wp-includes/class-wp-editor.php:_WP_Editors::enqueue_default_editor()

Enqueue all editor scripts.

wp-includes/widgets/class-wp-widget-media-audio.php:WP_Widget_Media_Audio::enqueue_admin_scripts()

Loads the required media files for the media manager and scripts for media widgets.

wp-includes/widgets/class-wp-widget-media-audio.php:WP_Widget_Media_Audio::enqueue_preview_scripts()

Enqueue preview scripts.

wp-includes/widgets/class-wp-widget-media-video.php:WP_Widget_Media_Video::enqueue_preview_scripts()

Enqueue preview scripts.

wp-includes/embed.php:enqueue_embed_scripts()

Enqueues embed iframe default CSS and JS.

wp-includes/class-wp-customize-nav-menus.php:WP_Customize_Nav_Menus::enqueue_scripts()

Enqueues scripts and styles for Customizer pane.

wp-login.php:login_header()

Output the login page header.

wp-admin/includes/dashboard.php:wp_dashboard_setup()

Registers dashboard widgets.

wp-admin/includes/class-wp-internal-pointers.php:WP_Internal_Pointers::enqueue_scripts()

Initializes the new feature pointers.

wp-admin/includes/template.php:iframe_header()

Generic Iframe header for use with Thickbox.

wp-admin/includes/media.php:wp_iframe()

Outputs the iframe to display the media upload page.

wp-admin/includes/class-custom-image-header.php:Custom_Image_Header::css_includes()

Set up the enqueue for the CSS files

wp-admin/includes/class-custom-background.php:Custom_Background::admin_load()

Set up the enqueue for the CSS & JavaScript files.

wp-includes/class-wp-customize-manager.php:WP_Customize_Manager::customize_preview_init()

Prints JavaScript settings.

wp-includes/general-template.php:add_thickbox()

Enqueues the default ThickBox js and css.

wp-includes/general-template.php:wp_admin_css()

Enqueues or directly prints a stylesheet link to the specified CSS file.

wp-includes/functions.php:wp_auth_check_load()

Load the auth check for monitoring whether the user is still logged in.

wp-includes/class-wp-admin-bar.php:WP_Admin_Bar::initialize()

Initializes the admin bar.

wp-includes/media.php:wp_enqueue_media()

Enqueues all scripts, styles, settings, and templates necessary to use all media JS APIs.

wp-includes/media.php:wp_video_shortcode()

Builds the Video shortcode output.

wp-includes/media.php:wp_playlist_scripts()

Outputs and enqueue default scripts and styles for playlists.

wp-includes/media.php:wp_audio_shortcode()

Builds the Audio shortcode output.

wp-includes/customize/class-wp-customize-color-control.php:WP_Customize_Color_Control::enqueue()

Enqueue scripts/styles for the color picker.

wp-includes/class-wp-customize-widgets.php:WP_Customize_Widgets::enqueue_scripts()

Enqueues scripts and styles for Customizer panel and export data to JavaScript.

wp-includes/class-wp-editor.php:_WP_Editors::enqueue_scripts()
Show 32 more used byHide more used by

Top ↑

Changelog

Changelog
VersionDescription
2.6.0Introduced.
Download the latest version of WordPress from https://wordpress.org/

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by the Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.