Learn
Field notes on getting 3D product models to actually work — on Shopify, in AR Quick Look, in Safari’s <model> element and on Android. Sourced from the specs and the platform docs, not from folklore. Every claim links to where it comes from.
Shopify & commerce
What storefronts actually accept, and what they silently do to your file after you upload it.
- My GLB is too big for Shopify — what actually happensShopify accepts GLBs up to 500 MB but silently re-optimizes anything over 15 MB. Here is what that does to your model, and how to stay in control.
- Shopify 3D model requirements, from the actual docsFormats, size limits, texture rules and scale conventions for Shopify 3D product media — quoted from Shopify docs, with what each rule means in practice.
- The pre-publish checklist for e-commerce 3D modelsEleven checks to run before a 3D product model goes live: size, textures, geometry, materials, scale, AR parity and validation — with the fix for each.
Apple, AR & USDZ
Quick Look, the Safari 27 <model> element, and every way a USDZ fails to load or renders wrong.
- USDZ not working in Quick Look: the ten real causesWhy AR Quick Look refuses to open your USDZ — packaging, MIME type, missing textures, memory limits — and how to tell which one you have hit.
- Why your USDZ renders pink in Quick LookPink or magenta in AR Quick Look means the renderer found a prim but not a usable surface shader. The five causes, and how to tell them apart.
- Why glTF to USDZ converters break your materialsUSDZ cannot represent transmission, volume, sheen or iridescence. What survives a glTF to USDZ conversion, what silently does not, and what to bake first.
- Safari's <model> element: what your USDZ needsSafari 27 ships the HTML <model> element on iOS, iPadOS and macOS. What it needs from your USDZ, how to mark it up, and what still fails.
- AR Quick Look vs Scene Viewer: what actually differsiOS wants USDZ, Android wants GLB, and Scene Viewer has hard limits Quick Look does not. The two AR delivery paths compared, with real numbers.
File size & formats
Geometry and texture compression explained honestly — including when the free tools are the right answer.
- Reducing GLB file size without wrecking qualityDraco, meshopt, quantization, KTX2 and WebP explained honestly — what each costs, what order to apply them, and which free tool to reach for first.
- WebP vs KTX2 textures: when to use whichWebP wins on download size, KTX2 wins on GPU memory. Which one your 3D model needs, what each costs, and why USDZ can use neither.
Validation & cleanup
Decoding validator output, and repairing the geometry that generators and scans hand you.
- Cleaning up AI-generated 3D models for commerceWhat Meshy, Tripo, TRELLIS and Hunyuan3D actually emit — normalized scale, tight UV atlases, floaters — and the repair order that makes them AR-ready.
- glTF validation errors, decodedWhat the Khronos glTF-Validator is telling you: the most common error codes, what each one actually means, and how to fix it in your exporter.
Reading about it is slower than measuring it. Drop your .glb, .gltf, or .usdz in and get every blocker on this page checked against the real bytes — packaging, textures, geometry, AR parity — with the fix for each one.