wp_add_inline_style( string $handle, string $data ): bool

Adds extra CSS styles to a registered stylesheet.


Styles will only be added if the stylesheet is already in the queue.
Accepts a string $data containing the CSS. If two or more CSS code blocks are added to the same stylesheet $handle, they will be printed in the order they were added, i.e. the latter added styles can redeclare the previous.

Top ↑

See also

Top ↑


$handle string Required
Name of the stylesheet to add the extra styles to.
$data string Required
String containing the CSS styles to be added.

Top ↑


bool True on success, false on failure.

Top ↑


File: wp-includes/functions.wp-styles.php. View all references

function wp_add_inline_style( $handle, $data ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );

	if ( false !== stripos( $data, '</style>' ) ) {
				/* translators: 1: <style>, 2: wp_add_inline_style() */
				__( 'Do not pass %1$s tags to %2$s.' ),
		$data = trim( preg_replace( '#<style[^>]*>(.*)</style>#is', '$1', $data ) );

	return wp_styles()->add_inline_style( $handle, $data );

Top ↑


Version Description
3.3.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    wp_add_inline_style allows you to print extra styling whenever a certain stylesheet is loaded. For instance suppose a plug-in or theme makes use of the class .mycolor in a stylesheet to set a background color. This can be over-ridden by a user chosen color, stored in the database by using wp_add_inline_style to print the extra styling.

     * Add color styling from theme
    function wpdocs_styles_method() {
    		get_template_directory_uri() . '/css/custom_script.css'
            $color = get_theme_mod( 'my-custom-color' ); //E.g. #FF0000
            $custom_css = "
                            background: {$color};
            wp_add_inline_style( 'custom-style', $custom_css );
    add_action( 'wp_enqueue_scripts', 'wpdocs_styles_method' );

You must log in before being able to contribute a note or feedback.