Skip to main content
View plugin on GitHub
See starters using this

gatsby-plugin-svgr-svgo

Plugin allows you to use SVGs as react components, configure SVGO(SVG optimization) settings and declare rules for SVG url loader with or without optimization.

npm version Drone

Install

npm install gatsby-plugin-svgr-svgo @svgr/webpack --save

Setup

Default configuration

Add to your gatsby-config.js

plugins: [`gatsby-plugin-svgr-svgo`];

By default there are two rules will be added:

  1. SVG as a react component(innline svg), SVGO enabled for all SVGs that have .inline postfix. Example: cat.inline.svg
import React from "react";
import CatInlineSvg from "../images/cat.inline.svg";

const IndexPage = () => (
  <div>
    <CatInlineSvg />
  </div>
);

export default IndexPage;
  1. SVG as a file that available by url, SVGO enabled for all svgs that have .svg. Example: cat.svg.
import React from "react";
import CatSvg from "../images/cat.svg";

const IndexPage = () => (
  <div>
    <img src={CatSvg} />
  </div>
);

export default IndexPage;

Advanced configuration

plugins: [
  {
    resolve: "gatsby-plugin-svgr-svgo",
    options: {
      inlineSvgOptions: [
        {
          test: /\.inline.svg$/,
          svgoConfig: {
            plugins: [
              {
                removeViewBox: false
              }
            ]
          }
        }
      ],
      urlSvgOptions: [
        {
          test: /\.svg$/,
          svgoConfig: {
            plugins: [
              {
                removeViewBox: false
              }
            ]
          }
        }
      ]
    }
  }
];

You can decalre various rules based on loader that should be used under inlineSvgOptions and urlSvgOptions.

test - pattern that will be used to match file name

svgoConfig - accepts plugins list with settings, list of available plugins(options) you can find here

svgo - disables SVGO if set in false

SVGO disabled example:

plugins: [
  {
    resolve: "gatsby-plugin-svgr-svgo",
    options: {
      urlSvgOptions: [
        {
          test: /\.svg$/,
          svgo: false
        }
      ]
    }
  }
];

Set URL loader fallback limit

By default webpack url-loader has a fallback to file-loader that converts the file from the original extension to base64. So if you want to set the limit from which it should be loaded directly from url instead of base64 loading just use limit option within urlLoaderOptions.

urlSvgOptions: [
  {
    test: /\.svg$/,
    svgoConfig: {
      plugins: [
        {
          removeViewBox: false,
        },
      ],
    },
    urlLoaderOptions: {
      limit: 512,
    },
  },
],