This document outlines the requirements for preparing and delivering 3D models for Wanna experiences, including Try-On and 3D Viewer. Follow these guidelines to ensure your assets render correctly and pass validation in WANNA Studio.
Overall Model Requirements and Limits
- Models must be delivered as valid glTF (.gltf) or GLB (.glb) files with all textures included
- Validate models using the Khronos 3D Viewer
- All transformations must be applied (freeze scale, rotation, and position) before export
- Maximum 105 primitives per model
- Archive file size (geometry + textures) must not exceed 50 MB
- Triangle count and texture size limits vary by category:
| Category | Max Triangles per Model | Max Texture Size |
|---|---|---|
| Footwear | 65,000 per shoe | 2048×2048 |
| Bags | 130,000 | 2048×2048 |
| Scarves | 130,000 | 2048×2048 |
| Watches | 130,000 | 2048×2048 |
| Other objects for 3D Viewer | 130,000 | 2048×2048 |
UV Maps & Texture Requirements
- Single UV set per object is required
- Textures:
- 8-bit per channel
- Max total pixels:
- Try-On: 18,873,368 px (per model)
- 3D Viewer: 37,748,736 px (≈ 9 × 2048 × 2048)
- Red ORM channel should contain AO map or #FFFFFF (default in Adobe Substance 3D Painter is #000000, which renders black)
UV spacing guidelines
| Texture Size | Min Island Padding |
|---|---|
| 512×512 | 4 px |
| 1024×1024 | 8 px |
| 2048×2048 | 16 px |
- Avoid placing UV islands near the edges of the UV space
UV tiling is supported (UDIMs outside 0‑1) starting with Web SDK 2.8 / iOS SDK 6.1
Transparency
- Use alpha channel or KHR_materials_transmission for transparent materials
- Stacked transparency (e.g., glass over gems) must use separate materials to ensure correct render order
Color Space
Wanna experiences support only sRGB color space due to iOS device limitations. All 3D models must be created and exported in sRGB to ensure accurate color reproduction.
Workflow:
- Start your project using the recommended settings
- Manually enable the AO channel for each texture set
- Export all texture maps as sRGB
Color space support requires Web SDK 2.6+ and iOS SDK 6.1+
Unsupported Features & Limitations
Certain features and data types are not supported by WANNA experiences and may cause your model to be rejected during validation or rendered incorrectly. These include unsupported extensions, texture maps, and materials.
For complete details, see Unsupported Features & Data Types.
Next Steps
- Review the Supported Extensions to understand which KHR and WANNA-specific extensions are allowed
- Follow the Model Orientation Guide to position your models correctly in 3D space
- Apply the 3D Model Optimisation Tips to improve performance and reduce file size
- Understand the Automatic Changes by WANNA Backend to anticipate how your files may be processed after upload
- Learn about Using WANNA Studio