Documentation

Optimizations

SVGM runs 34 optimization passes in a fixed-point loop until the document stabilizes. The default preset enables all 34. The safe preset excludes structure and geometry passes. Passes are grouped into five categories and execute in the order listed below.

Removal

16 passes

Strips dead weight: metadata, editor artifacts, empty elements, deprecated attributes, and provably invisible content.

Normalization

4 passes

Tightens values: collapses whitespace, rounds numbers, shortens colors, and removes spec defaults.

Structure

5 passes

Simplifies the tree: inlines styles, collapses unnecessary groups, cleans up IDs, and redistributes attributes between groups and children.

Geometry

5 passes

Compresses path and shape data: converts shapes, simplifies transforms, optimizes path commands, and merges adjacent paths.

Output

4 passes

Final minification: sorts attributes and defs for compression, minifies styles, and strips formatting whitespace.

Optimizations

Removal

removeDoctypeRemove <!DOCTYPE> declarations.

removeProcInstRemove XML processing instructions.

removeCommentsRemove HTML/XML comments.

removeMetadataRemove <metadata> elements.

removeEditorDataRemove editor-specific elements, attributes, and namespaces.

removeDescRemove editor-generated <desc> and <title> elements.

removeDeprecatedAttrsRemove deprecated SVG attributes.

removeEmptyAttrsRemove attributes with empty string values.

removeEmptyTextRemove empty text elements.

removeEmptyContainersRemove empty <g>, <defs>, and <symbol> elements.

removeHiddenElemsRemove provably invisible elements.

removeUnusedNamespacesRemove unused xmlns declarations.

removeUselessDefsRemove unreferenced elements inside <defs>.

removeNonInheritableGroupAttrsRemove non-inheritable presentation attributes from <g> elements.

removeUselessStrokeAndFillRemove useless stroke and fill sub-properties.

cleanupEnableBackgroundRemove deprecated enable-background attribute and style property.

Normalization

cleanupAttrsCollapse whitespace in attribute values.

cleanupNumericValuesRound numeric attributes and strip unnecessary precision.

convertColorsNormalize colors to their shortest representation.

removeUnknownsAndDefaultsRemove attributes matching SVG spec defaults.

Structure

inlineStylesMerge <style> elements and inline safe CSS rules.

collapseGroupsRemove unnecessary <g> wrappers.

cleanupIdsRemove unreferenced IDs and shorten referenced ones.

moveElemsAttrsToGroupPromote common child attributes to parent group.

moveGroupAttrsToElemsDistribute group transforms to children when safe.

Geometry

convertShapeToPathConvert shapes to <path> when shorter.

convertEllipseToCircleConvert <ellipse> to <circle> when rx equals ry.

convertTransformSimplify and apply transform attributes.

convertPathDataOptimize SVG path d attributes.

mergePathsMerge adjacent <path> siblings with identical attributes.

Output

sortAttrsSort element attributes alphabetically.

sortDefsChildrenSort <defs> children for better gzip compression.

minifyStylesMinify CSS in <style> elements and inline styles.

minifyWhitespaceRemove formatting whitespace from the document.