Swyvl supports uploading .glb and .gltf files. This format is ideal for showcasing single objects like designed buildings, machinery, or vehicles.
Step 1: Upload Your 3D Model
Open your Project in the Builder.
In the Toolbar, go to 3D Data > 3D Model.
Choose whether to:
Add New to upload a new model (.glb or .gltf), or
Choose Existing from your Resources folder.
Once uploaded, Swyvl will process the model and prepare it for placement on the map.
Step 2: Confirm Placement Location
After upload, you’ll be prompted to confirm where on the map your model should appear:
Move or zoom the map to the correct location.
Click Confirm to place the model.
📌 Note: You can fine-tune the position after it’s placed using the Properties Panel.
Step 3: Adjust Position & Scaling
Click the settings icon next to the model in the Project Data Sidebar to open the Properties Panel.
Placement Tab
Adjust latitude and longitude to fine-tune exact coordinates.
Set the height:
Choose between Above Ground Level or Above Sea Level
Modify the orientation:
Heading (rotation around vertical axis)
Pitch (tilt forward/back)
Roll (tilt side-to-side)
Scale the model size
Toggle Drape on Terrain
When Drape on Terrain is enabled, the model will automatically align with the terrain and manual height options will be hidden
To manually control the model's elevation, disable Drape on Terrain
Styling Tab
Set the opacity of the model.
⚠️ Troubleshooting Tips
Model appears cut off or floating:
Turn off Drape on Terrain and adjust the Height manually.Model looks misaligned or distorted:
Use Pitch, Roll, and Scale to fine-tune.Model doesn’t display correctly with terrain:
If you're using the Google 3D Tiles basemap, try switching to OpenStreetMap or Google Satellite Imagery — some terrain features may interfere with your model.
You’re Done
Your 3D model is now part of your Swyvl project. You can reposition, restyle, or remove it anytime.
Need to display a larger mesh or terrain layer instead?
👉 Learn how to add 3D Tilesets