File Format Requirements
FrameKit accepts 3D model files in the following formats. For the best results, prepare your model according to the guidelines below.
Supported formats
| Format | Extension | Notes |
|---|---|---|
| glTF Binary | .glb | Recommended. Self-contained, includes textures. |
| Wavefront OBJ | .obj | Include the .mtl file and any texture images in a ZIP archive. |
| Filmbox | .fbx | Ensure textures are embedded or provided separately. |
Model preparation guidelines
Geometry
- Clean mesh — Remove duplicate vertices, non-manifold edges, and internal geometry that would not be visible in renders.
- Scale — Match your model’s scale to real-world dimensions. FrameKit uses the dimensions you specify in your product settings to correct any discrepancies, but an accurately scaled model produces the most reliable results.
- Polygon count — Aim for a mesh that is detailed enough to look accurate in close-up renders, but not so dense that it becomes impractical. For most products, 50,000–500,000 polygons is a reasonable range.
Textures
- Use power-of-two texture dimensions (e.g. 512, 1024, 2048, 4096) for compatibility.
- Texture maps should be embedded in the file or included alongside it. Broken texture references will result in a model with missing materials.
- PBR (Physically Based Rendering) materials — roughness, metalness, normal maps — are supported and recommended for realistic results.
Orientation
- The model should be upright with its base resting on the ground plane (Z = 0).
- The front of the product should face the positive Y axis.
File size limit
The maximum upload size is 10 GB per model file. If your file exceeds this, try reducing texture sizes or simplifying geometry.