Skip to content
SVG spritemap plugin for webpack
Branch: master
Clone or download
Latest commit ba6ad4a Jul 17, 2019

SVG Spritemap Webpack Plugin

npm npm codevov license

This webpack plugin generates a single SVG spritemap containing multiple <symbol> elements from all .svg files in a directory. In addition, it can optimize the output and can also generate a stylesheet containing the sprites to be used directly from CSS. Chris Coyier has a good write-up about the why's and how's of this technique on CSS Tricks. Use it in combination with the svg4everybody package to easily and correctly load SVGs from the spritemap in all browsers.

Version ^2.0.0 of this plugin is compatible with webpack ^4.0.0. When using an older version of webpack, make sure to install the ^1.0.0 (svg-spritemap-webpack-plugin@^1.0.0) release of this plugin.


npm install svg-spritemap-webpack-plugin --save-dev


Webpack configuration
This plugin can be added to webpack like any other, documentation on all configuration options is available.

const SVGSpritemapPlugin = require('svg-spritemap-webpack-plugin');

module.exports = {
    // ...
    plugins: [
        new SVGSpritemapPlugin()

SVG element
When there's a file phone.svg in the source directory and the prefix option is set to sprite- (default), the sprite can be included in a HTML-file like so:

    <use xlink:href="/path/to/spritemap.svg#sprite-phone"></use>


SVG for Everybody adds SVG External Content support to all browsers.

It's a good idea to combine the svg-spritemap-webpack-plugin with svg4everybody. This can be done by passing an options object or true to the svg4everybody options key or by executing SVG4Everybody manually.


This project is licensed under the MIT license.

You can’t perform that action at this time.