Tutorial: logos



For documentation on using logos, see https://shields.io/docs/logos

Contributing Logos

Our preferred way to consume icons is via the SimpleIcons logo. As a first port of call, we encourage you to contribute logos to the SimpleIcons project. Please review their guidance before contributing.

In some cases we may also accept logo submissions directly. In general, we do this only when:

  • We have a corresponding badge on the homepage, (e.g. the Eclipse logo because we support service badges for the Eclipse Marketplace). We may also approve logos for other tools widely used by developers.
  • The logo provided in SimpleIcons is unclear when displayed at small size on a badge.
  • There is substantial benefit in using a multi-colored icon over a monochrome icon.
  • The logo doesn't meet the requirements to be included in the SimpleIcons set.

If you are submitting a pull request for a custom logo, please:

  • Minimize SVG files through SVGO. This can be done in one of two ways
    • The SVGO Command Line Tool
      • Install SVGO
        • With npm: npm install -g svgo
        • With Homebrew: brew install svgo
      • Run the following command svgo --precision=3 icon.svg -o icon.min.svg
      • Check if there is a loss of quality in the output, if so increase the precision.
    • The SVGOMG Online Tool
      • Click "Open SVG" and select an SVG file.
      • Set the precision to about 3, depending on if there is a loss of quality.
      • Leave the remaining settings untouched (or reset them with the button at the bottom of the settings).
      • Click the download button.
  • Set a viewbox and ensure the logo is scaled to fit the viewbox, while preserving the logo's original proportions. This means the icon should be touching at least two sides of the viewbox.
  • Ensure the logo is vertically and horizontally centered.
  • Ensure the logo is minified to a single line with no formatting.
  • Ensure the SVG does not contain extraneous attributes.
  • Ensure your submission conforms to any relevant brand or logo guidelines.


We try to ensure our logos are compliant with brand guidelines. If one of our custom logos does not conform to the necessary brand guidelines, please open an issue on the shields.io tracker and we'll work with you to resolve it. If a logo from the simple-icons set does not conform to the relevant brand guidelines, please open an issue on the simple-icons tracker first.