Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A grunt task for rewriting urls inside a stylesheet, using base64-encoded strings.
JavaScript CSS
tag: 0.0.1

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

This task converts all images found within a stylersheet (those within a url( ... ) declaration) into base64-encoded data URI strings.


  • Supports both local & remote images.
  • Ability to specify a size limit. Default is 32kb, or IE8's limit.
  • Existing data URIs will be ignored.
  • Skip specific images by specifying a directive comment.
  • Includes two helpers: encode_stylesheet to encode a stylesheet, and encode_image to encode an image.

Getting Started

Install this plugin with: grunt install grunt-image-embed

Next, add this line to your project's grunt.js file:


Lastly, add the configuration settings to your grunt.js file.


This task has two required properties, src and dest. src is the path to your stylesheet and dest is the file this task will write to (relative to the grunt.js file). If this file already exists it will be overwritten.

An example configuration looks like this:

  imageEmbed: {
    dist: {
      src: [ "css/styles.css" ],
      dest: "css/output.css"

Optional Configuration Properties

ImageEmbed can be customized by specifying the following options:

  • maxImageSize: The maximum size of the base64 string in bytes. This defaults to 32768, or IE8's limit. Set this to 0 to remove the limit and allow any size string.
  • baseDir: If you have absolute image paths in your stylesheet, the path specified in this option will be used as the base directory.

Skipping Images

Specify that an image should be skipped by adding the following comment after the image:

background: url(image.gif); /*ImageEmbed:skip*/

Known Issues

  • Only one image per line can be read at the moment, so run this task before minifying your CSS file.
Something went wrong with that request. Please try again.