Swyvl supports uploading .glb and .gltf 3D models to help you visualize detailed structures, equipment, or assets directly on your map. This is ideal for showcasing single objects like buildings, machinery, or site elements.
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 the 3D Model
To reposition or refine your model:
Open the Properties Panel
Click the settings icon next to the model in the Project Data Sidebar.
In the Placement Tab, you can:
Adjust latitude and longitude
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
⚠️ 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.
Optional: Adjust Model Styling
In the Styling Tab of the Properties Panel, you can:
Set the opacity of the 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