“No Valid CRS Found in File Headers” — How to Fix Your File’s Coordinate System
What Does This Error Mean?
When you upload a raster file (GeoTIFF) to Stitch3D, we read its embedded coordinate reference system (CRS) to correctly position and display your data. If we can’t identify a recognized CRS in the file’s headers, you’ll see this error:
No valid CRS found in file headers
This doesn’t mean your data is corrupted or that its coordinates are wrong. It means the file is missing the metadata that identifies which coordinate system those numbers belong to. Without it, Stitch3D has no way to know where on Earth your data is located.
Why Does This Happen?
This is almost always caused by how the file was exported from your photogrammetry or GIS software. Common causes include:
- Photogrammetry software writing an anonymous datum. Tools like Agisoft Metashape, Pix4D, DJI Terra, and OpenDroneMap sometimes write the correct projection parameters but fail to embed a recognized authority code (like an EPSG code). The result is a file that says “Lambert Conic Conformal centered at -105.5°” without saying “and that’s EPSG:6431.”
- Exporting without specifying a CRS. Some software will export a GeoTIFF using the project’s internal coordinate system without writing a standard EPSG code to the file header.
- Custom or user-defined CRS. If your project uses a local or custom coordinate system, the file may contain a
32767 sentinel value — the GeoTIFF spec’s placeholder for “user-defined” — which is not a real EPSG code and cannot be interpreted.
The Right Fix: Re-export With an Explicit EPSG Code
The best solution is to go back to your source software and re-export the file with a valid EPSG code explicitly set. This ensures the CRS is written correctly into the file headers rather than patched in afterward.
General steps in any photogrammetry or GIS software:
- Before exporting, locate the Coordinate Reference System or Projection setting in the export dialog.
- Search for your CRS by its EPSG code — for example,
32614 for WGS 84 / UTM Zone 14N.
- If you’re unsure of your EPSG code, you can look it up at epsg.io by searching your state, country, or zone.
- Export as GeoTIFF with that CRS explicitly selected.
- Re-upload to Stitch3D.