Save SVG File in Python

Quick Answer

Use SVGDocument.save(output_path) to save an SVG document to a file. If the SVG references external resources such as images or CSS, use FileSystemResourceHandler to save the SVG together with its linked resources in local storage.

Save SVG Documents

Most SVG workflows end with saving a document. After creating a new SVG, loading an existing file, or editing the SVG DOM, call document.save() to write the result. Saving keeps the output in SVG format. To export SVG to PDF, PNG, JPG, or other formats, use the conversion APIs described in Convert SVG Files in Python.

Before running the examples, install Aspose.SVG for Python via .NET in your Python environment.

Aspose.SVG APIs Used

API	Purpose
SVGDocument	Loads, edits, and saves SVG documents
SVGDocument.save()	Saves SVG content to a file, URL, stream, or resource handler
Url	Represents a URL or file URL used as a save target
FileSystemResourceHandler	Saves SVG and linked resources to local file storage
ResourceHandler	Base resource handler for controlling external resource output

Save SVG to a File

The following example loads an SVG file, modifies the root element, and saves the result to another file.

import os
from aspose.svg import SVGDocument

# Load an SVG file, edit it, and save the result
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "with-resources.svg")
output_path = os.path.join(output_folder, "modified-example.svg")
os.makedirs(output_folder, exist_ok=True)

with SVGDocument(input_path) as document:
    document.document_element.set_attribute("data-edited", "true")
    document.save(output_path)

Save SVG to a URL Path

You can also pass a Url object to save(). This is useful when your code works with URL-based paths rather than plain file-system strings.

import os
from aspose.svg import SVGDocument, Url

# Save an SVG document to a URL-based file path
input_folder = "data/"
output_folder = "output/"
os.makedirs(output_folder, exist_ok=True)

input_path = os.path.join(input_folder, "text.svg")
output_url = Url(os.path.join(output_folder, "text-out.svg"), os.getcwd())

with SVGDocument(input_path) as document:
    document.save(output_url)

Save SVG with Linked Resources

An SVG document can reference external resources such as images, CSS files, or fonts. Use FileSystemResourceHandler when you want to save the SVG and its linked resources into local storage.

The following example saves with-resources.svg and associated resources to the output folder.

import os
from aspose.svg import SVGDocument
from aspose.svg.saving.resourcehandlers import FileSystemResourceHandler

# Save an SVG document and its linked resources to local storage
input_folder = "data/"
output_folder = os.path.abspath(os.path.join("output", "with-resources"))
input_path = os.path.join(input_folder, "with-resources.svg")
os.makedirs(output_folder, exist_ok=True)

with SVGDocument(input_path) as document:
    document.save(FileSystemResourceHandler(output_folder))

After running the code, check the output folder. It should contain the saved SVG document and the resources that were included by the original SVG.

Save SVG from a Stream with Resources

If the SVG file is opened as a stream, pass a base URI when creating SVGDocument so relative resources can be resolved. Then save the document and resources explicitly.

import os
from aspose.svg import SVGDocument
from aspose.svg.saving.resourcehandlers import FileSystemResourceHandler

# Load SVG from a stream and save it with linked resources
input_folder = "data/"
output_folder = os.path.abspath(os.path.join("output", "stream-save"))
input_path = os.path.join(input_folder, "with-resources.svg")
output_path = os.path.join(output_folder, "with-resources.svg")
os.makedirs(output_folder, exist_ok=True)

with open(input_path, "rb") as file_stream:
    with SVGDocument(file_stream, ".") as document:
        document.save(output_path, FileSystemResourceHandler(output_folder))

Common Mistakes and Fixes

Problem	Likely cause	Fix
Saved file is not created	The output directory does not exist	Create the folder with os.makedirs(output_folder, exist_ok=True) before saving
Linked images or CSS are missing	The SVG references external resources that were not copied	Use FileSystemResourceHandler to save SVG with resources
Resources are not resolved when loading from a stream	The document has no base URI for relative links	Pass a valid base URI to SVGDocument(file_stream, base_uri)
Edits are not present in the saved SVG	save() was called before editing or outside the active document workflow	Modify the loaded document and call document.save() after edits
Conversion output was expected	SVGDocument.save() saves SVG, not PDF or raster images	Use Converter.convert_svg() to export SVG to PDF, PNG, JPG, and other formats

FAQ

How do I save an SVG file in Python?

Load or create an SVGDocument, edit it if needed, and call document.save(output_path).

Does SVGDocument.save() convert SVG to PNG or PDF?

No. SVGDocument.save() saves SVG. Use the conversion APIs when you need PDF, PNG, JPG, or another output format.

How do I save SVG with external images?

Use FileSystemResourceHandler so the SVG document and its linked resources are written to local storage.

Why do I need a base URI when loading SVG from a stream?

The base URI tells the document how to resolve relative links to images, CSS, fonts, and other resources.

Can I save an edited SVG to a different file?

Yes. Load the source SVG, make changes, and pass a new output path to document.save().

Related Articles

• Create SVG File explains how to create or load SVG documents before saving.
• Edit SVG File shows how to modify SVG content before calling save().
• Navigate SVG explains how to find and inspect SVG elements before editing.
• Convert SVG Files in Python covers exporting SVG to PDF, PNG, JPG, and other formats.
• Convert SVG to PNG in Python explains PNG export and image save options.