Skip to main content

Missing USD File

Error code: MISSING_USD_FILE

"It looks like there wasn't a USD file in your upload - please make sure that you include a USD, USDZ, USDA or USDC file in the root directory of your upload."

What This Means​

Miris could not find a USD file in the root of your uploaded folder. A USD file in the root directory is required — it serves as the entry point for your 3D asset.

Common Causes​

  • The wrong folder was selected during upload — for example, a textures/ or geo/ subfolder was uploaded instead of the parent asset folder that contains the USD file
  • The USD file was placed inside a subfolder rather than directly in the root of the upload
  • A .usdz archive was unzipped and the extracted texture folder was uploaded without the USD file that was also inside the archive
  • The upload contained only texture files, FBX, OBJ, or other non-USD formats
  • The file extension was not one of the accepted USD variants (.usd, .usdz, .usda, .usdc)

How to Fix It​

  1. Check the top level of your upload folder — not any subfolder inside it — for a file ending in .usd, .usda, .usdc, or .usdz
  2. If there's no USD file there, you've likely uploaded the wrong folder. Go up one level in your file browser and upload the parent folder instead
  3. Re-upload the corrected folder
tip

If you have multiple USD files, only one should be in the root. Additional USD files (such as referenced sub-layers) should be in subdirectories. See Multiple Root USD Files if you encounter that error.

Still seeing this error after following the steps above? Contact support with your asset name and a description of what you've tried.