Uploading Assets
Upload images, audio, video, and 3D models into your ShapeBox project from your computer, a URL, or the Marketplace.
Uploading Assets
ShapeBox gives you several ways to bring external files into a project. All uploaded assets are private to your project unless you explicitly share them.
From your computer
Drag and drop
The fastest method — drag files directly from your file browser onto the Asset Panel. You can drop one file or an entire folder.
Upload button
- Open the Asset Panel at the bottom of the editor.
- Click Upload (or the
+icon). - Select one or more files from the file picker.
- The files appear in the Uploads tab once processing is complete.
Large files (over 50 MB) show a progress bar. Do not close the browser tab until the upload finishes.
From a URL
Import publicly accessible files directly by URL — useful for shared design assets, CDN-hosted textures, or stock photo links:
- Click Upload → Import from URL.
- Paste the direct link to the file.
- Click Import.
ShapeBox downloads and stores the file inside your project. It is no longer linked to the source URL — if the original changes, your copy stays the same.
Supported drag targets during upload
| Drop target | Result |
|---|---|
| Asset Panel | Uploads file to the Uploads tab |
| Viewport (on empty space) | Uploads and places the model or image in the scene |
| Viewport (on an object) | Uploads and applies as a texture or material |
| Inspector material slot | Uploads and assigns directly to that slot |
File size limits
| File type | Max size per file |
|---|---|
| Images | 50 MB |
| 3D models (GLTF/GLB) | 200 MB |
| 3D models (OBJ/FBX) | 100 MB |
| Audio | 50 MB |
| Video | 500 MB |
Need to upload files larger than these limits? Contact support@shapebox.io — Enterprise plans can enable custom limits.
Importing 3D models
When you upload a .gltf, .glb, .obj, or .fbx file, ShapeBox processes it automatically:
- Materials are extracted and made available in your project's material library.
- Textures embedded in the model are unpacked and added to the Uploads tab.
- Animations (GLTF/GLB and FBX) are imported and appear under the model in the Animation timeline.
- Hierarchy is preserved — parent/child object relationships are maintained.
Processing time depends on file complexity. A progress indicator appears in the Asset Panel. The model is ready to use once the indicator clears.
Replacing an asset
If you update a file externally and want to bring in the new version:
- Right-click the asset in the Asset Panel.
- Select Replace.
- Upload the new file.
All references in the scene update automatically — you do not need to re-assign materials or re-import.
Troubleshooting
| Problem | Solution |
|---|---|
| Upload fails silently | Check your file size against the limits above |
| 3D model appears pink / untextured | Textures are missing from the file; embed them before exporting from your 3D tool |
| Audio does not play in preview | Ensure the file is .mp3, .wav, or .ogg and under 50 MB |
| FBX animations are missing | Re-export from your 3D software with "Bake animations" enabled |