Overlay custom imagery to match your site
Add tiled imagery layers to make your Swyvl Project match the real-world context your team works in - not just a generic basemap.
When the map reflects your site, the data just makes more sense.
Imagery
TMS Tiles
Upload a ZIP file containing your TMS (Tile Map Service) tiles. These display as an overlay above the base map.
Use pre-rendered tiles in TMS format
Tiles display as a full overlay layer
Ideal for custom basemaps or orthophotos
XYZ Tiles
Upload a ZIP file of XYZ Tiles (Slippy Map Tiles) to show map tile mosaics.
Imagery appears as a full overlay on your map
Useful for drone imagery or raster styling
Zoom in to get great detail
How It Works
Upload
Select the Imagery tool from the top toolbar and upload a ZIP file of TMS or XYZ tiles.
Add to Project
Your tiles will appear as an overlay layer above your basemap.
Adjust Appearance
You can adjust opacity and toggle the imagery layer on or off at any time.
Share and Explore
Published Projects will include your imagery layer, giving teams and clients a more familiar, site-specific view.
FAQs
Can I upload multiple imagery layers to a Project?
Yes - you can upload multiple imagery layers to a Project.
What's the difference between TMS and XYZ?
Both are tiled image formats, but TMS uses a reversed Y-axis compared to XYZ. If you’re unsure, XYZ is often the safer default and you can flip the tile latitude in the Properties Panel within Swyvl if needed.
Can I adjust transparency or turn imagery off?
Yes - you can adjust opacity and toggle the imagery on or off at any time using the Sidebar or Properties Panel.
Can I move an imagery layer once it is added?
No — imagery layers are locked in position based on the georeferenced data in the file. They can’t be repositioned manually.
What is the difference between adding an aerial photo as a Site Plan v Imagery?
When added as Imagery, aerial photos are tiled and optimized for high-resolution zooming. Site Plans are single static images manually placed over the map.
