Quick answer
To check a 3MF file, confirm that it opens as a ZIP package, that the model declares the unit you expect, that every object and build item is present, and that colors and materials point at resources that exist. Then open it in the slicer you print from. A package can be valid and still lose data in a tool that supports only part of the specification.
- A 3MF is a ZIP package, so any archive tool can inspect it.
- Check the unit, the object count, and the build items before you edit or scale.
- Broken references, such as a color pointing at a resource that does not exist, are a common cause of missing color.
- Valid is not the same as compatible: test in the slicer you will use.
Step 1: Confirm the package opens
Copy the file, rename the copy to .zip, and open it. A healthy package has a 3D folder with the model file, a content-types file, and a relationships folder. If the archive does not open, the file is truncated or was not saved as a 3MF.
Step 2: Read the model header
Open the model file in a text editor. The root element carries the unit. When it is missing, the specification default is millimeter. Check that the unit matches the size you expect before you scale anything.
Step 3: Check objects and build items
- Objects
Each object has an ID and either a mesh or a list of components.
- Build items
The build section lists which objects are placed on the plate, and where. An object that is defined but not in the build is not printed.
- Components
A component object refers to other objects, and every referenced ID must exist.
Step 4: Check the references
Colors and materials work through references. An object or triangle that points at a property resource that does not exist has a broken reference. Applications handle this differently: some ignore it, some report an error, and some drop the color. Confirm that every property reference in the file points at a resource that is defined.
Step 5: Use a tool instead of reading XML
- Open the free 3MF Color Inspector
Drop the file into the inspector on this site. It reads the package in your browser and lists objects, colors, materials, textures, transforms, and reference integrity. Nothing is uploaded.
- Compare with a reference file
Generate the reference file the inspector offers, round-trip it through your tool, and compare what survived.
- Open it in your slicer
Check the preview and a few sliced layers. The slicer is the final authority for your print.
Common questions
Technical answers and limitations.
Is there a tool that validates a 3MF file?+
The 3MF Consortium publishes the specification and a compatibility matrix, and some applications validate on import. The free 3MF Color Inspector on this site checks package structure and reference integrity locally. The final test is opening the file in the application you will print from.
Why does my 3MF open in one program but not another?+
Each application implements a subset of the specification and its extensions. A file that uses an extension the second program does not support can fail to open or lose data.
Can a 3MF file be damaged but still open?+
Yes. A package can open while missing a referenced resource, so a tool shows the geometry and drops the color. Checking the references finds this kind of damage.
What unit does a 3MF use by default?+
Millimeter, when the model does not declare another unit.
Primary references
Verify the underlying guidance.
Apply these checks in Meshworthy
Inspect the model, review the operation, and verify the export.
Meshworthy applies these checks locally on your Mac and does not upload your model.
Inspect a 3MF before you edit it ↗