Svgo Versions Save

Notice

An update on what happened with v3.3.0 and v3.3.1. While we have retained CJS support, the migration to EMS has changed the acceptable ways to import SVGO, in ways that users depended on before. This effectively made SVGO v3 a breaking change.

Rather than resolve or workaround these differences, we've opted to release SVGO v3.3.2, which is effectively a revert to v3.2.0, and deprecate versions v3.3.0 and v3.3.1. We'll then proceed to work on releasing v4 which will document the breaking changes, and feature further breaking changes that were slated for v4, like disabling removeViewBox by default.

Before the v4.0.0 release, I'll put more focus on testing and use release candidates, just to help make the release go smoothly! 👍🏽

Sorry for the headache, and thanks for your patience.

Notice

SVGO v3.3.0, which was meant to migrate to ESM without breaking CJS support, unfortunately broke CJS projects. There was a mistake with exports, so the loadConfig function wasn't available in the CJS bundle and lead to issues for many users.

Thanks to everyone who raised the issue, and to @nuintun who submitted a pull request to resolve it so quickly.

I apologize for letting that breaking change through, and will aim to do better. Namely, by adding more tests to cover our exports, and any other public interface in general for each distribution of SVGO, so this doesn't happen again.

SVGO v3.3.1 should resolve the issue for CJS projects, but if you encounter anything else, do let us know by opening an issue on GitHub.

Deprecated

This release introduced breaking changes, which have been reverted in v3.3.2. The bug fixes will be reintroduced in v4.0.0.

What's Changed

ESM

SVGO is now a dual package, serving for both Common JS and ESM usage. We believe there shouldn't be any problems, especially as SVGO as largely stateless, but feel free to open an issue if you encounter problems with this.

To be explicit, this is not a breaking change, and SVGO should continue to work in Common JS projects!

Thanks to @jdufresne for doing the bulk of the work.

Default Behavior

• convertColors, now converts all references to colors excluding references to IDs to lowercase. This can be disabled by setting convertCase to false.

Bug Fixes

• cleanupIds, treat both URI encoded and non-URI encoded IDs as the same. By @liuweifeng in #1982
• collapseGroups, check styles as well as attributes. By @johnkenny54 in #1952
• collapseGroups, move attributes atomically. By @johnkenny54 in https://github.com/svg/svgo/pull/1930
• convertPathData, fix q control point when item is removed. By @KTibow in https://github.com/svg/svgo/pull/1927
• convertPathData, preserve vertex for markers only paths. By @SethFalco in #1967
• mergePaths, don't merge paths if attributes/styles depend depend on the nodes bounding box. By @johnkenny54 in #1964
• moveElemsAttrsToGroups, no longer moves the transforms if group has the filter attribute. By @johnkenny54 in #1933
• prefixIds, fixed issue where some IDs were not prefixed when style tag contained XML comments. By @john-neptune in #1942
• removeHiddenElems, don't remove node if child element has a referenced ID. By @johnkenny54 in https://github.com/svg/svgo/pull/1925
• removeHiddenElems, treat path[opacity=0] as a non-rendering node. By @johnkenny54 in #1948
• removeUselessDefs, don't remove node if child element has an ID. By @johnkenny54 in https://github.com/svg/svgo/pull/1923
• When stringifying path data, include a space before numbers represented in scientific notation. By @johnkenny54 in #1961
• No longer crashes when the output (-o argument) ends with a trailing slash to a location that didn't exist. By @SethFalco in #1954

SVG Optimization

• convertColors, introduce parameter to convert colors to common casing (lowercase/uppercase). By @JayLeininger in https://github.com/svg/svgo/pull/1692
• removeDeprecatedAttrs, new plugin that is disabled by default to remove SVG attributes that are deprecated. By @jdufresne in #1869

Metrics

Before and after using vectors from various sources, with the default preset of each respective version:

SVG	Original	v3.2.0	v3.3.0	Delta
Arch Linux Logo	9.529 KiB	4.115 KiB	4.097 KiB	⬇️ 0.018 KiB
Blobs	50.45 KiB	42.623 KiB	42.609 KiB	⬇️ 0.014 KiB
Isometric Madness	869.034 KiB	540.582 KiB	540.073 KiB	⬇️ 0.509 KiB
tldr-pages Banner	2.071 KiB	1.07 KiB	1.07 KiB
Wikipedia Logo	161.551 KiB	111.668 KiB	111.668 KiB

Before and after of the browser bundle of each respective version:

	v3.2.0	v3.3.0	Delta
svgo.browser.js	910.9 kB	753.0 kB	⬇️ 157.9 kB

What's Changed

Bug Fixes

• Convert Path Commands, fix instances were q was incorrectly converted to t. By @KTibow in https://github.com/svg/svgo/pull/1889
• Convert Transform, fix for some transforms that weren't being converted correctly. By @SethFalco in https://github.com/svg/svgo/pull/1916

SVG Optimization

• Convert Path Commands, improves closing paths and how we determine if to use absolute or relative commands. By @KTibow in https://github.com/svg/svgo/pull/1867
• Convert Path Commands, round arc or convert to lines based on the sagitta, can be disabled by setting smartArcRounding to false. By @KTibow in https://github.com/svg/svgo/pull/1873
• Convert Path Commands, convert cubic Bézier curves to quadratic Bézier curves where possible, can be disabled by setting convertToQ to false. By @KTibow in https://github.com/svg/svgo/pull/1889

Performance

• Merge Paths, refactor for performance with large files. By @mozzie in https://github.com/svg/svgo/pull/1764 and https://github.com/svg/svgo/pull/1904
• Convert Path Commands, refactor #stringifyPathData for performance. By @SethFalco in https://github.com/svg/svgo/pull/1900
• Use Set instead of Array for faster lookups. By @SethFalco in https://github.com/svg/svgo/pull/1899

Metrics

Before and after using vectors from various sources, with the default preset of each respective version:

SVG	Original	v3.1.0	v3.2.0	Delta
Arch Linux Logo	9.529 KiB	4.162 KiB	4.115 KiB	⬇️ 0.047 KiB
Blobs	50.45 KiB	42.949 KiB	42.623 KiB	⬇️ 0.326 KiB
Isometric Madness	869.034 KiB	550.153 KiB	540.582 KiB	⬇️ 9.571 KiB
tldr-pages Banner	2.071 KiB	1.07 KiB	1.07 KiB
Wikipedia Logo	161.551 KiB	116 KiB	111.668 KiB	⬇️ 4.332 KiB

Before and after of the browser bundle of each respective version:

	v3.1.0	v3.2.0	Delta
svgo.browser.js	660.9 kB	910.9 kB	⬆️ 250 kB

What's Changed

Bug Fixes

• Prefix IDs, correctly prefix IDs when <style> tag contains XML comments. By @john-neptune in https://github.com/svg/svgo/pull/1736
• Remove Hidden Elements, improve handling of definitions (<defs>), namely when <defs> are defined at the end of the document. By @KTibow in https://github.com/svg/svgo/pull/1879
• Cleanup Enable Background, clean up inline-styles too. By @SethFalco in https://github.com/svg/svgo/pull/1866
• Cleanup IDs, handle URI encoded references properly. By @SethFalco in https://github.com/svg/svgo/pull/1880
• Inline Styles, no longer crashes on non-inlined selectors with a pseudo-class. By @SethFalco in https://github.com/svg/svgo/pull/1865
• Improve handling of URL references in reference attributes (url('#a')) across various plugins. By @SethFalco in https://github.com/svg/svgo/pull/1881

SVG Optimization

• Remove Unknowns and Defaults, now removes defaults in XML declarations too, enabled by default and can be toggled with defaultMarkupDeclarations. By @SethFalco in https://github.com/svg/svgo/pull/1872

Metrics

Before and after using vectors from various sources, with the default preset of each respective version:

SVG	Original	v3.0.5	v3.1.0	Delta
Arch Linux Logo	9.529 KiB	4.608 KiB	4.162 KiB	⬇️ 0.446 KiB
Blobs	50.45 KiB	42.949 KiB	42.949 KiB
Isometric Madness	869.034 KiB	550.153 KiB	550.153 KiB
tldr-pages Banner	2.071 KiB	1.07 KiB	1.07 KiB
Wikipedia Logo	161.551 KiB	117.146 KiB	116 KiB	⬇️ 1.146 KiB

Before and after of the browser bundle of each respective version:

	v3.0.5	v3.1.0	Delta
svgo.browser.js	657.5 kB	660.9 kB	⬆️ 3.4 kB

What's Changed

Bug Fixes

• Cleanup IDs, correctly handle references to other nodes in animations. By @KTibow in https://github.com/svg/svgo/pull/1862
• Convert Path Commands, fix issue when removing redundant Z between mergable M/m commands. By @KTibow in https://github.com/svg/svgo/pull/1856
• Convert Path Commands, adhere to error/precision in z conversions. By @KTibow in https://github.com/svg/svgo/pull/1842
• Remove Empty Containers, skip if parent node is <switch>, as empty containers can be used for attributes like requiredFeatures. By @vincentbernat in https://github.com/svg/svgo/pull/1747
• Remove Hidden Elements, when removing a hidden definition, also remove nodes that reference it. By @SethFalco in https://github.com/svg/svgo/pull/1852
• Output the optimization stats (profit) in red if the file size increased. By @gimler in https://github.com/svg/svgo/pull/1162
• Type definition files now correctly use the .d.ts file extension instead of .ts. By @Exotelis in https://github.com/svg/svgo/pull/1780

Chores

• Improved exported types for the #loadConfig method. By @nuintun in https://github.com/svg/svgo/pull/1844

Metrics

Before and after using vectors from various sources, with the default preset of each respective version:

SVG	Original	v3.0.4	v3.0.5	Delta
Arch Linux Logo	9.529 KiB	4.735 KiB	4.608 KiB	⬇️ 0.127 KiB
Blobs	50.45 KiB	42.949 KiB	42.949 KiB
Isometric Madness	869.034 KiB	550.593 KiB	550.153 KiB	⬇️ 0.44 KiB
tldr-pages Banner	2.071 KiB	1.07 KiB	1.07 KiB
Wikipedia Logo	161.551 KiB	117.152 KiB	117.146 KiB	⬇️ 0.006 KiB

Before and after of the browser bundle of each respective version:

	v3.0.4	v3.0.5	Delta
svgo.browser.js	656.9 kB	657.5 kB	⬆️ 0.6 kB

Includes various bug fixes for existing plugins and a new optimization. Also splits removeXMLNS, which removed XLink, into two separate plugins, removeXMLNS and removeXlink.

What's Changed

Default Behavior

• Remove XML Namespace, no longer removes the XLink (xmlns:xlink) namespace. If that is desirable, you should enable the new Remove XLink (removeXlink) plugin, which does more while being safer. By @TrySound and @SethFalco in https://github.com/svg/svgo/pull/1535

Bug Fixes

• Convert Path Commands, ignore instances where transform applied via style tag. By @SethFalco in https://github.com/svg/svgo/pull/1830
• Inline Styles, inline properties with the same specificity in the order that they appear in the stylesheet. By @SethFalco in https://github.com/svg/svgo/pull/1831
• Inline Styles, don't remove class or id from node if it's traversed in another CSS selector. By @SethFalco in https://github.com/svg/svgo/pull/1832 and https://github.com/svg/svgo/pull/1836
• Don't trim pre elements in foreignObject. By @SethFalco in https://github.com/svg/svgo/pull/1796
• Don't crash when encountering @-webkit-keyframes in <style> node. By @SethFalco in https://github.com/svg/svgo/pull/1826

SVG Optimization

• Convert Path Commands, convert to z command if going back to initial position, or drop z if redundant. By @KTibow in https://github.com/svg/svgo/pull/1822
• Inline Styles, when inlining a CSS property that's already declared in a presentation attribute of the node, drop the attribute. By @SethFalco in https://github.com/svg/svgo/pull/1829
• Remove XLink, new plugin that removes the XLink (xmlns:xlink) namespace and migrates from XLink attributes to the SVG 2 equivalent. Disabled by default. By @TrySound and @SethFalco in https://github.com/svg/svgo/pull/1535

Metrics

Before and after using vectors from various sources, with the default preset of each respective version:

SVG	Original	v3.0.3	v3.0.4	Delta
Arch Linux Logo	9.529 KiB	4.738 KiB	4.735 KiB	⬇️ 0.003 KiB
Blobs	50.45 KiB	42.949 KiB	42.949 KiB
Isometric Madness	869.034 KiB	550.699 KiB	550.593 KiB	⬇️ 0.106 KiB
tldr-pages Banner	2.071 KiB	1.07 KiB	1.07 KiB
Wikipedia Logo	161.552 KiB	118.441 KiB	117.152 KiB	⬇️ 1.289 KiB

Before and after of the browser bundle of each respective version:

	v3.0.3	v3.0.4	Delta
svgo.browser.js	651.7 kB	656.9 kB	⬆️ 5.2 kB

Includes various bug fixes and optimizations for existing plugins.

We're also revamped the documentation for the project. You can find it on svgo.dev! The frontend for svgo.dev is maintained in svg/svgo.dev, contributions are welcome.

What's Changed

Default Behavior

• Remove Comments, introduces preservePatterns parameter. Preserves legal comments by default, same as the previous behavior, but can now be overridden. By @SethFalco in https://github.com/svg/svgo/pull/1812
• Remove Description, set the removeAny parameter to false by default for accessibility. By @SethFalco in https://github.com/svg/svgo/pull/1806

Bug Fixes

• Remove Raster Images, removes inlined JPEG images. By @abejfehr in https://github.com/svg/svgo/pull/1742
• Cleanup IDs, correctly handle when 2 IDs have been referenced in a single attribute. By @SethFalco in https://github.com/svg/svgo/pull/1795
• Cleanup IDS, correctly handle when we've encountered a reference to a node that doesn't exist. By @SethFalco in https://github.com/svg/svgo/pull/1817
• Inline Styles, treat style prop keys as case-insensitive. By @SethFalco in https://github.com/svg/svgo/pull/1797
• Inline Styles, remove all classes in multiclass selector. By @SethFalco in https://github.com/svg/svgo/pull/1801
• Inline Styles, ignore empty CSS blocks instead of adding empty style attribute. By @SethFalco in https://github.com/svg/svgo/pull/1823
• Minify Styles, removes unused class selectors when the document has no classes. By @SethFalco in https://github.com/svg/svgo/pull/1800
• Prefix IDs, reuse the same prefix when encountering an ID multiple times. By @SethFalco in https://github.com/svg/svgo/pull/1814
• Remove Hidden Elements, stops removing non-rendering elements like masks. By @SethFalco in https://github.com/svg/svgo/pull/1793
• Reuse Paths, creates a new ID if the current one is referenced by another element. By @SethFalco in https://github.com/svg/svgo/pull/1784
• Reuse Paths, removes redundant defs children after optimization. By @SethFalco in https://github.com/svg/svgo/pull/1785
• Reuse Paths, stops duplicating attributes into the shared definition. By @SethFalco in https://github.com/svg/svgo/pull/1791
• Don't crash on a null, undefined, or empty plugin. Instead, log a warning and ignore it. By @SethFalco in https://github.com/svg/svgo/issues/1128

SVG Optimization

• Convert Transform, omit spaces between functions. By @SethFalco in https://github.com/svg/svgo/pull/1802
• Remove Scripts, removes callbacks (on*) and href attributes with javascript: URIs. By @cakeinpanic and @SethFalco in https://github.com/svg/svgo/pull/1807, https://github.com/svg/svgo/pull/1818, https://github.com/svg/svgo/pull/1819, https://github.com/svg/svgo/pull/1820
• Convert One-Stop Gradients, new plugin to convert gradients with one stop to a solid color, disabled by default. By @SethFalco in https://github.com/svg/svgo/pull/1790

Performance

• Various optimizations for path handling. By @marvinhagemeister in https://github.com/svg/svgo/pull/1716 and https://github.com/svg/svgo/pull/1717

Chores

• Revise the README. By @ADTC in https://github.com/svg/svgo/pull/1731
• Fix dead link to postcss-svgo in README. By @Lehoczky in https://github.com/svg/svgo/pull/1770
• Replace webpack loader library in README as previous was deprecated. By @tanyabouman in https://github.com/svg/svgo/pull/1771

Metrics

Before and after using vectors from various sources, with the default preset of each respective version:

SVG	Original	v3.0.2	v3.0.3	Delta
Arch Linux Logo	8.584 KiB	4.748 KiB	4.747 KiB	⬇️ 0.001 KiB
Blobs	50.45 KiB	42.949 KiB	42.949 KiB
Isometric Madness	869.034 KiB	550.829 KiB	550.699 KiB	⬇️ 0.13 KiB
tldr-pages Banner	2.071 KiB	1.07 KiB	1.07 KiB
Wikipedia Logo	161.552 KiB	118.441 KiB	118.441 KiB

Before and after of the browser bundle of each respective version:

	v3.0.2	v3.0.3	Delta
svgo.browser.js	643.5 kB	651.7 kB	⬆️ 8.2 kB

Installing @types/csso no longer required

• store exposed types only in .d.ts files, no longer need to enable js checking
• update svgo.browser.js
• fixed "begin" attribute cleanup

Thanks to @Kreeg, @XhmikosR and @TrySound