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.

See also


Name of the stylesheet to add the extra styles to.
String containing the CSS styles to be added.


bool True on success, false on failure.


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 );



User Contributed Notes

  1. Skip to note 2 content

    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.