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

Parameters

$handlestring

Name of the stylesheet. Should be unique.

$srcstring|false

Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory. If source is set to false, stylesheet is an alias of other stylesheets it depends on.

$depsstring[]optional

An array of registered stylesheet handles this stylesheet depends on. Default empty array.Default: array()

$verstring|bool|nulloptional

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: false

$mediastringoptional

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

Return

bool

Whether the style has been registered. True on success, false on failure.

Uses · 3

• _wp_scripts_maybe_doing_it_wrong()Helper function to output a _doing_it_wrong message when applicable.
• wp_styles()Initializes $wp_styles if it has not been set.
• wp_styles()::add()

Used by · 24

• WP_Duotone::output_footer_assets()Outputs all necessary SVG for duotone filters, CSS for classic themes.
• WP_Interactivity_API::data_wp_router_region_processor()Processes the `data-wp-router-region` directive.
• _wp_theme_json_webfonts_handler()Runs the theme.json webfonts handler.
• register_block_style_handle()Finds a style handle for the block metadata field.
• twentyfifteen_scripts()Enqueues scripts and styles.
• twentyfourteen_scripts()Enqueues scripts and styles for the front end.
• twentyseventeen_scripts()Enqueues scripts and styles.
• twentysixteen_scripts()Enqueues scripts and styles.
• twentythirteen_scripts_styles()Enqueues scripts and styles for the front end.
• twentytwelve_scripts_styles()Enqueues scripts and styles for front end.
• wp_enqueue_block_style()Enqueues a stylesheet for a specific block.
• wp_enqueue_embed_styles()Enqueues the CSS in the embed iframe header.

Source

View on Trac ↗View on GitHub ↗

129function wp_register_style( $handle, $src, $deps = array(), $ver = false, $media = 'all' ) {130	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );131 132	return wp_styles()->add( $handle, $src, $deps, $ver, $media );133}

History

Introduced in 2.6.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/functions.wp-styles.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.