Check your SVG’s viewBox and size

What the checker reads

An SVG’s size information lives on the root <svg> element, in up to three attributes. The checker shows each one and what follows from them:

• viewBox: four numbers (min-x, min-y, width and height) that define which area of the drawing’s own coordinate system is shown (MDN: viewBox). Its width and height must be positive.
• width and height: the size the file asks to be displayed at, with or without a unit.
• Units: px, in, cm, mm, pt or pc, or none at all (a bare number is read as pixels). Percentages say nothing about physical size.
• Aspect ratios: the width-to-height proportion of the viewBox and of the width/height attributes, side by side.
• Physical size: shown in inches and millimeters when the width and height use absolute units (in, cm, mm, pt or pc).

<svg xmlns="http://www.w3.org/2000/svg"
     width="4in" height="3in"
     viewBox="0 0 400 300">

Reading the status

Missing. Without a viewBox, the drawing has no defined relationship to its width and height, so resizing it can crop or shift the artwork instead of scaling it. Cricut doesn’t document viewBox requirements; FixMySVG flags a missing one because it makes size and scaling less predictable.

Invalid. A viewBox like 0 0 -400 300 has a negative width. The SVG 2 specification treats a negative width or height as an error that invalidates the viewBox, and a value of zero disables rendering altogether (W3C SVG 2: the viewBox attribute). Either way, the file no longer says clearly how the drawing maps to its size. The usual repair is 0 0 followed by the width and height of the drawing area in the file’s own units, and Safe Fix makes exactly that replacement when the file has a usable width and height.

Mismatch. When the proportions differ, the SVG standard fits the viewBox inside the width and height without distorting it, centered by default, which leaves empty space on two sides; preserveAspectRatio="none" stretches it instead (MDN: preserveAspectRatio). Cricut doesn’t document how Design Space handles either case, so it’s safer to make the proportions match.

Units, pixels and inches

Absolute units have fixed definitions in the CSS standard that SVG uses: 1 in = 2.54 cm = 96 px, 1 pt = 1/72 in and 1 pc = 1/6 in (W3C CSS Values: absolute lengths). A file sized in inches or millimeters therefore states its physical size directly, and the checker converts it to both.

Pixel sizes are where the confusion starts. By the standard, the 1200 × 900 px sample is 12.5 × 9.4 in. Design Space, however, is widely reported by Cricut users to read pixels at 72 per inch, which would make the same file about 16.7 × 12.5 in. Cricut doesn’t document its conversion, so for pixel-sized files, check the size in Design Space after uploading.

Fixing viewBox and size problems

For background and step-by-step fixes, read what a missing viewBox does to an SVG and why an SVG imports at the wrong size in Cricut. If the viewBox is fine but the upload still fails, the main troubleshooting guide covers the other causes.