# inline-css > Inline your CSS properties into the `style` attribute in an html file. Useful for emails. Inspired by the [juice](https://github.com/Automattic/juice) library. ## How It Works This gulp plugin takes an html file and inlines the CSS properties into the style attribute. `/path/to/file.html`: ```html

Test

``` `style.css` ```css p { text-decoration: underline; } ``` Output: ```html

Test

``` ## What is this useful for ? - HTML emails. For a comprehensive list of supported selectors see [here](http://www.campaignmonitor.com/css/) - Embedding HTML in 3rd-party websites. - Performance. Downloading external stylesheets delays the rendering of the page in the browser. Inlining CSS speeds up this process because the browser doesn't have to wait to download an external stylesheet to start rendering the page. ## Install Install with [npm](https://npmjs.org/package/inline-css) ``` npm install --save inline-css ``` ## API ### inlineCss(options) #### options.extraCss Type: `String` Default: `""` Extra css to apply to the file. #### options.applyStyleTags Type: `Boolean` Default: `true` Whether to inline styles in ``. #### options.applyLinkTags Type: `Boolean` Default: `true` Whether to resolve `` tags and inline the resulting styles. #### options.removeStyleTags Type: `Boolean` Default: `true` Whether to remove the original `` tags after (possibly) inlining the css from them. #### options.removeLinkTags Type: `Boolean` Default: `true` Whether to remove the original `` tags after (possibly) inlining the css from them. #### options.preserveMediaQueries Type: `Boolean` Default: `false` Preserves all media queries (and contained styles) within `` tags as a refinement when `removeStyleTags` is `true`. Other styles are removed. #### options.applyWidthAttributes Type: `Boolean` Default: `false` Whether to use any CSS pixel widths to create `width` attributes on elements. ## License MIT © [Jonathan Kemp](http://jonkemp.com)