SVG upload problems
Unsupported items in a Cricut SVG: what each one is and how to fix it
By FixMySVG · Published Oct 4, 2026 · 8 min read
Part of: SVG not uploading to Cricut
If Cricut Design Space shows “Your file includes unsupported items”, your SVG contains something Cricut lists as unsupported for uploads, such as editable text, a clipping path, a gradient or an image. Cricut documents five kinds of unsupported items. Below they’re kept apart from the extra warnings FixMySVG adds, with the fix for each one.
On this page
Cricut documentation
When a file contains unsupported items, Design Space shows: “Your file includes unsupported items. For best results, use a different file type.” Cricut’s help lists five kinds of unsupported items in .svg and .dxf files: pattern fills (color gradients, textures, patterns, images and photographs), clipping paths, editable text, linked images and embedded unsupported images (Cricut Help: Image uploads — unsupported items).
The message itself doesn’t say which item caused it. Some Cricut users report upload warnings that name the element type, such as “Text elements” or “non embedded image elements”, but often you have to find the culprit yourself. Look at the file’s structure rather than its preview, because most of these items look perfectly normal on screen; the free Cricut SVG checker shows that structure for you.
Find the unsupported items in your SVG
The checker names each item it finds and how to fix it. Your SVG is processed in your browser and stays on your device.
Cricut’s list vs FixMySVG’s extra checks
Two different things often get mixed up: items Cricut itself documents as unsupported, and structures that aren’t on Cricut’s list but can still make the result differ from your design. The Source column shows which is which.
| Item | In the SVG code | Source | Usual fix |
|---|---|---|---|
| Editable text | <text> | Cricut | Convert to outlines |
| Clipping paths and masks | <clipPath>, <mask> | Cricut | Release, then trim |
| Pattern fills and gradients | <pattern>, <linearGradient>, <radialGradient> | Cricut | Solid colors or expand |
| Linked images | <image> pointing to another file | Cricut | Delete, or trace into vectors |
| Embedded images (PNG, JPG) | <image> with the picture inside | Cricut | Trace, or Print Then Cut |
| Filters and effects | <filter> (shadow, blur) | FixMySVG | Remove or expand |
| Embedded web content | <foreignObject> | FixMySVG | Redraw as shapes |
| Reused shapes | <use> | FixMySVG | Unlink clones |
| Outline-only shapes | stroke with no fill | FixMySVG | Stroke to path |
| Hidden or invisible objects | display="none", 0% opacity | FixMySVG | Delete (Safe Fix) |
FixMySVG guidance
The FixMySVG rows are our own guidance, based on what those SVG features do and on problems commonly reported by Cricut users. Cricut doesn’t list them as unsupported items; we flag them because they can change what you get on the mat. The Cricut SVG requirements reference keeps the same split for every rule.
A different message, “File Too Large”, has a different cause: Cricut restricts SVGs to 5,000 paths (Cricut Help: How to upload images). That one has its own guide to the 5,000-path limit.
Real analyzer result
Sample file: 10-multiple-issues.svg
A sample file with several unsupported items
- Paths
- 5
- Commands (≈ nodes)
- 26
- Elements
- 26
- Groups
- 3
- File size
- 5.4 KB
- Size
- 500px × 400px
- viewBox
- 0 0 500 400
- Complexity
- Low
Cricut compatibility: Not ready
- XML errors
- Editable text
- Clipping paths
- Linked images
The five unsupported items Cricut lists, and how to fix them
Each quote in this section comes from Cricut’s help article on unsupported upload items.
Editable text
Cricut’s wording is direct: “Text needs to be converted into a shape before it is sent to Cricut Design Space”. In an SVG, live text is a <text> element: the characters plus a font name, not the shapes of the letters.
Fix: convert the text in your design app while the font is installed — Illustrator: Type › Create Outlines; Inkscape: Path › Object to Path; Affinity Designer: Layer › Convert to Curves. The guide on SVG text that won’t work in Cricut covers fonts, script lettering and how to check the result.
Clipping paths and masks
Cricut describes clipping paths as “multiple shapes layered together so that one shape masks or clips the other shapes”. In SVG code that wording covers both <clipPath> and <mask>. Either way, the parts you can’t see are still in the file: the clip or mask is only an instruction to hide them.
Fix: release the clip or mask, then trim the artwork for real so the hidden parts are gone. Illustrator: Object › Clipping Mask › Release, then Pathfinder › Crop or Intersect. Inkscape: Object › Clip › Release, then Path › Intersection. The clipping path guide walks through the trickier cases.
Pattern fills, gradients and textures
Cricut defines pattern fills as “fills on shapes that are anything other than flat colors” and names color gradients, textures, patterns, images and photographs as examples. In the code, such a shape has a fill like fill="url(#…)" that points to a <pattern>, <linearGradient> or <radialGradient>. Design Space separates a design into layers by color, and a fill made of many colors doesn’t correspond to one color layer.
Fix: give each shape a solid color. If a pattern is meant to be cut, expand it into real shapes first (Illustrator: Object › Expand). If a gradient is meant to be printed, export that part as a PNG and use Print Then Cut instead.
Linked images
Cricut means “images that are not embedded within your file”: an <image> element whose address points to a separate file or a web URL. The picture isn’t inside the SVG, so there’s nothing in the file for Design Space to read.
Fix: if the image was a leftover reference or placeholder, delete it. If it’s part of the design, trace it into vector shapes in your design app. If it’s a photo you want to print, remove it from the SVG and upload it separately as a PNG or JPG for Print Then Cut. Embedding it alone doesn’t make it cuttable, as the next item explains.
Embedded images (non-vector)
An SVG can also carry a PNG or JPG inside it, stored as encoded data. Cricut lists embedded unsupported images and explains that .svg and .dxf are vector formats Design Space uses to create cut files separated into layers by color. A photo is made of pixels, not cut lines, so it can’t become one of those layers.
Fix: trace the image into vector shapes, or use Print Then Cut for the photo. Tracing is a judgment call — a simple logo traces cleanly, a photo doesn’t — so FixMySVG leaves it to you.
Other structures FixMySVG flags (not on Cricut’s list)
These aren’t Cricut rules. FixMySVG warns about them because each one can make the cut result differ from what you see in your design app.
Filters and effects
Drop shadows, blurs and glows are SVG filters: rendering effects with no outline of their own, so there’s nothing for a blade to follow. Remove them, or expand the effect into real shapes if it has to be part of the cut.
Embedded web content (foreignObject)
A <foreignObject> lets an SVG carry HTML content, such as formatted text from a web page. It isn’t vector artwork, so FixMySVG treats it as a problem. Recreate that part with regular shapes.
Reused shapes (use)
A <use> element draws a copy of another shape by reference; Inkscape clones and Illustrator symbols can export this way. FixMySVG counts each copy towards the path total and recommends unlinking them (Inkscape: Edit › Clone › Unlink Clone; Illustrator: break the link to the symbol), so every copy is a real shape and nothing depends on the reference being followed.
Outline-only shapes
Commonly reported by Cricut users: Design Space ignores stroke width and fills in closed shapes that only have an outline, so a ring can come in as a solid disc. If the outline itself should be cut, turn it into a shape — Illustrator: Object › Expand; Inkscape: Path › Stroke to Path; Affinity Designer: Layer › Expand Stroke. If shapes arrive as solid black, see why an SVG shows a black box in Cricut.
Hidden, invisible and off-canvas objects
Old versions on hidden layers, shapes at 0% opacity, shapes with no fill and no stroke, and leftovers outside the artboard don’t belong in a cut file. Users commonly report that shapes with no fill can come in filled, often black. Of everything on this page, this is the group FixMySVG removes automatically, as long as nothing else in the file depends on those objects.
Check your SVG for unsupported items
Drop an SVG here
or
One .svg file, up to 15 MB.
Processed in your browser — your SVG stays on your device.
What FixMySVG can and can’t fix here
Safe Fix works in groups of changes. Each group is checked by rendering the file before and after and comparing the pixels, and any group that would change how your design looks is undone. Safe Fix is included in the free plan with a daily allowance.
What FixMySVG can and can’t do
- Automatically fixableRemoves hidden objects, invisible objects and objects completely outside the canvas, plus unused clipping paths, masks, gradients, patterns and filters left in the file’s definitions, editor data, scripts and empty groups.
- Manual action recommendedEditable text, clipping paths and masks in use, pattern fills and gradients, linked or embedded images, outline-only shapes, filters,
<use>copies and<foreignObject>: FixMySVG shows what it found and how to fix each one in your design app. - Can’t be reliably repaired automaticallyConverting text without the exact font, and turning a photo into faithful cut shapes. FixMySVG doesn’t attempt either, because guessing would change your design.
Once the Cricut items are fixed, upload again. If the file still fails for another reason, the complete guide to SVGs that won’t upload to Cricut goes through the remaining causes, and the full FixMySVG checker with Safe Fix shows a before and after of every automatic change.
Clean up what can be fixed automatically
Run Safe Fix on your SVG and compare the before and after.
Frequently asked questions
- What does “Your file includes unsupported items” mean in Cricut Design Space?
- Your SVG contains something Cricut lists as unsupported in uploads: pattern fills (including gradients), clipping paths, editable text, linked images or embedded non-vector images. Convert or remove those items in your design app and upload again.
- Are gradients supported in Cricut SVG uploads?
- No. Cricut’s help counts color gradients as pattern fills, which are on its unsupported list. Use solid colors for cut layers, or print the gradient with Print Then Cut.
- Does Cricut support masks in SVG files?
- Cricut describes clipping paths as shapes layered so that one “masks or clips” the others, so SVG masks fall under the same unsupported item. Release the mask and trim the shapes for real.
- Are filters and <use> elements on Cricut’s unsupported list?
- No, Cricut doesn’t mention them. FixMySVG warns about them because effects have nothing to cut and referenced copies depend on software following the reference, but that is our guidance, not a Cricut rule.
- Can FixMySVG remove unsupported items automatically?
- It removes hidden and invisible objects, editor data and unused definitions automatically. Text, clipping paths, masks, pattern fills and images need your design app, because changing them automatically could alter the design.
Sources
- Cricut documentationCricut Help: Image uploads — unsupported items
- Cricut documentationCricut Help: How to upload images into Design Space
- SpecificationMDN: the clipPath element
- SpecificationMDN: the mask element
- SpecificationMDN: the pattern element
- SpecificationMDN: the image element
Related SVG guides
SVG structure7 min read
Clipping paths in SVG files for Cricut: what they are and how to remove them
Cricut lists clipping paths as unsupported in SVG uploads. Learn what a clipPath is, how to find one and how to flatten it in Illustrator, Inkscape or Affinity.
SVG appearance problems6 min read
SVG text not working in Cricut? How to turn the text into shapes
Why editable text in an SVG fails in Cricut Design Space, why the font matters, and how to convert text to outlines in Illustrator, Inkscape and Affinity.
SVG appearance problems8 min read
Why your SVG shows a black box in Cricut Design Space
SVG showing a black box or solid shape in Cricut Design Space? See the possible causes, from unfilled shapes and masks to images and CSS, and how to fix each.
SVG preparation9 min read
How to prepare an SVG for Cricut: an 11-step checklist before you upload
Prepare an SVG for Cricut before you export: text, clipping paths, images, colors, hidden objects, path count, size and viewBox, then one final check.