The usual way to load SVG into Fabric.js is loadSVGFromString followed by util.groupSVGElements, which sizes the group to what is drawn. An element outside the SVG's viewBox, or a hidden one, then moves and resizes the whole artwork. A Fabric.js import SVG through the engine keeps the file's own frame instead.
Loading the live demo. Its code is below.
"use client";
import { type FabricObject, Group, loadSVGFromString, util } from "fabric";
import { useDocumentEngine } from "fabricjs-document-engine/react";
import {
FileUpIcon,
FolderTreeIcon,
ImportIcon,
ScissorsIcon,
ShapesIcon,
} from "lucide-react";
import { useTranslations } from "next-intl";
import { useRef, useState } from "react";
import { DemoCanvas, DemoFrame, Status, Toolbar, ToolButton } from "./demo-ui";
import { useFabricCanvas } from "./use-fabric-canvas";
/**
* A badge drawn in a 240 × 150 viewBox, plus one shape far outside it and
* one hidden shape. Grouping by content lets those two move the badge.
*/
const SAMPLE = `<svg xmlns="http://www.w3.org/2000/svg" width="240" height="150" viewBox="0 0 240 150">
<rect x="10" y="10" width="220" height="130" rx="18" fill="#ffd666"/>
<circle cx="70" cy="75" r="36" fill="#f2836f"/>
<rect x="124" y="52" width="86" height="16" rx="8" fill="#0d0d0d"/>
<rect x="124" y="82" width="60" height="16" rx="8" fill="#6f00ff"/>
<circle cx="900" cy="600" r="40" fill="#5fe6c4"/>
<rect x="-500" y="-300" width="40" height="40" fill="#7ad9ec" style="display:none"/>
</svg>`;
const GROUPED = `<svg xmlns="http://www.w3.org/2000/svg" width="240" height="150" viewBox="0 0 240 150">
<g id="card" data-role="background">
<rect x="10" y="10" width="220" height="130" rx="18" fill="#ffd666"/>
<g id="avatar" opacity="0.9">
<circle cx="70" cy="75" r="36" fill="#f2836f"/>
<circle cx="70" cy="66" r="12" fill="#ffffff"/>
</g>
<g id="lines">
<rect x="124" y="52" width="86" height="16" rx="8" fill="#0d0d0d"/>
<rect x="124" y="82" width="60" height="16" rx="8" fill="#6f00ff"/>
</g>
</g>
</svg>`;
function outline(object: FabricObject, depth = 0): string[] {
const named = object as FabricObject & { svgId?: string };
const label = `${" ".repeat(depth)}${object instanceof Group ? "▸ " : "· "}${named.svgId ?? object.type}`;
return object instanceof Group
? [
label,
...object.getObjects().flatMap((child) => outline(child, depth + 1)),
]
: [label];
}
export default function SvgImportDemo() {
const t = useTranslations("demos");
const { elementRef, canvas } = useFabricCanvas();
const engine = useDocumentEngine(canvas);
const fileRef = useRef<HTMLInputElement>(null);
const [message, setMessage] = useState("");
const [tree, setTree] = useState<string[]>([]);
function clear() {
if (!engine) return;
setTree([]);
engine.canvas.remove(...engine.canvas.getObjects());
}
// The usual way: Fabric's parser, then a group sized to the content.
async function importWithFabric() {
if (!engine) return;
clear();
const { objects, options } = await loadSVGFromString(SAMPLE);
const group = util.groupSVGElements(
objects.filter(Boolean) as FabricObject[],
options
);
group.set({ left: 120, top: 75, originX: "left", originY: "top" });
engine.canvas.add(group);
setMessage(t("svgImport.fabric"));
}
async function importSvg(svg: string, offscreen: "keep" | "clip") {
if (!engine) return;
clear();
try {
const { warnings } = await engine.importSvg(svg, {
left: 120,
top: 75,
offscreen,
});
setMessage(
warnings.length > 0
? t("svgImport.warnings", { count: warnings.length })
: t("svgImport.engine")
);
} catch (error) {
setMessage(t("svgImport.failed", { message: String(error) }));
}
}
async function importGroups() {
if (!engine) return;
clear();
try {
const { objects } = await engine.importSvg(GROUPED, {
left: 120,
top: 75,
as: "objects",
preserveGroups: true,
});
setTree(objects.flatMap((object) => outline(object)));
setMessage(t("svgImport.groups"));
} catch (error) {
setMessage(t("svgImport.failed", { message: String(error) }));
}
}
async function openFile(file: File | undefined) {
if (!engine || !file) return;
clear();
try {
await engine.importSvg(await file.text(), {
left: 20,
top: 20,
fit: { width: 440, height: 260 },
});
setMessage(t("svgImport.file", { name: file.name }));
} catch (error) {
setMessage(t("svgImport.failed", { message: String(error) }));
}
}
return (
<DemoFrame>
<DemoCanvas elementRef={elementRef} label={t("canvas")} />
<Toolbar>
<ToolButton
icon={ImportIcon}
label={t("svgImport.withEngine")}
primary
disabled={!engine}
onClick={() => void importSvg(SAMPLE, "keep")}
/>
<ToolButton
icon={ShapesIcon}
label={t("svgImport.withFabric")}
disabled={!engine}
onClick={() => void importWithFabric()}
/>
<ToolButton
icon={ScissorsIcon}
label={t("svgImport.clip")}
disabled={!engine}
onClick={() => void importSvg(SAMPLE, "clip")}
/>
<ToolButton
icon={FolderTreeIcon}
label={t("svgImport.keepGroups")}
disabled={!engine}
onClick={() => void importGroups()}
/>
<ToolButton
icon={FileUpIcon}
label={t("svgImport.open")}
disabled={!engine}
onClick={() => fileRef.current?.click()}
/>
<input
ref={fileRef}
type="file"
accept=".svg,image/svg+xml"
className="sr-only"
tabIndex={-1}
aria-hidden
onChange={(event) => {
void openFile(event.target.files?.[0]);
event.target.value = "";
}}
/>
</Toolbar>
<Status tone={message ? "ok" : "idle"}>
{message || t("svgImport.hint")}
</Status>
{tree.length > 0 && (
<pre className="rounded-md border bg-muted/40 p-2 font-mono text-[12px] leading-5">
{tree.join("\n")}
</pre>
)}
</DemoFrame>
);
}Import an SVG file
const { objects, viewport, warnings } = await engine.importSvg(svgText, {
left: 40,
top: 40,
});- Elements land where the SVG puts them, after
viewBoxandpreserveAspectRatio. - The result is one group with a fixed layout the size of the viewport, so nothing inside can move it.
- The import is one undo step, and every object gets an id.
viewportis the size of the SVG's frame, which helps when you add SVG to canvas at a chosen size.
To open a file the user picks:
input.addEventListener("change", async () => {
const file = input.files?.[0];
if (file)
await engine.importSvg(await file.text(), {
fit: { width: 400, height: 300 },
});
});Keep groups
Fabric's parser flattens every <g>, and each shape inherits its group's id. preserveGroups: true rebuilds the groups:
const { objects } = await engine.importSvg(svgText, {
preserveGroups: true,
as: "objects",
});- Each
<g>and<a>becomes a Fabric group, nested as in the file, with its id, opacity and clip path. - Shapes lose ids they only inherited from a group.
- Every object and group gets
svgId,svgClassandsvgData(itsdata-*attributes), which are saved with the document. - A
<use>that points to nothing is left out. Fabric stops at the first such link, so before this the shapes after it were missing.
Place and fit the artwork
| Option | Values | Default |
|---|---|---|
left, top | Where the viewport's top-left corner lands | 0 |
fit | { width, height, mode }, mode is 'contain', 'cover' or 'fill' | none |
offscreen | 'keep', 'drop' or 'clip' | 'keep' |
as | 'group' or 'objects' | 'group' |
viewport | 'preserve' or 'content' | 'preserve' |
offscreen: "drop"leaves out elements entirely outside the viewport, and"clip"hides what lies outside it.as: "objects"adds separate objects in the same places, for files the user will take apart.viewport: "content"uses the bounds of what is drawn, like Fabric's own grouping. An SVG with no size always uses it.
Keep the SVG's groups
Fabric's parser flattens every <g> into separate shapes, so a logo or an icon set arrives as loose pieces (fabric.js #899). With preserveGroups: true, each <g> and <a> comes back as a Fabric group, in the same order:
const { objects } = await engine.importSvg(svgText, {
as: "objects",
preserveGroups: true,
});
const card = engine.getObjectById("card");- A group keeps its
id, sogetObjectByIdfinds it, and its opacity and clip path move onto the group. - Shapes lose ids they only inherited from their group.
- Every group and shape gets
svgId,svgClassandsvgData(itsdata-*attributes), saved with the document. - Shapes keep the exact place they had, because each group is built around shapes that already carry their full transform.
A <use> that points to nothing is now left out. Before, Fabric stopped expanding every later <use> after such a link.
Untrusted files
Every Fabric.js import SVG call cleans the file before Fabric parses it:
- Scripts, event handlers such as
onload,foreignObjectand links to other files are removed. - Image addresses that
limits.isAllowedUrlrefuses are left out. - An SVG with too many elements, or nested too deep, is refused with
UNSAFE_DOCUMENT, using the samelimitsas documents. - Text that is not an SVG rejects with
SVG_IMPORT_FAILED.
warnings lists what was removed or dropped, with the codes SVG_CONTENT_REMOVED, SVG_IMAGE_BLOCKED and SVG_OFFSCREEN_DROPPED. To export the canvas back to SVG, see SVG export. The options are listed with the DocumentEngine methods, and the safety limits on the security page.