General
What types of files can I upload to Swyvl?
Swyvl supports the following file types:
360 Photos: JPEG (equirectangular, 2:1 aspect ratio)
Still Photos: PNG, JPEG
Site and Floor Plans: PNG or JPEG (convert PDFs before uploading)
GPX Files: For path-based tours
GeoJSON Files: For linework or area overlays
3D Models: GLB or GLTF
3D Tilesets: JSON (3D Tiles 1.0 or 1.1)
TMS/XYZ Imagery: Zipped tile layers
COG (Cloud-Optimized GeoTIFFs): For orthomasaics or raster imagery
Can I turn off the map?
The map is a core part of the Swyvl experience and cannot be turned off. However, you can choose a basemap style that suits your project — including satellite, terrain, or simple vector maps — in the Basemap section of the Sidebar.
How do I set the start view of my project?
To set the starting view (or "home view") that users see when they first open your project:
Move the map to your preferred view — including location, angle, and zoom level.
Open the Settings in the Sidebar.
Scroll to Starting Camera and click Set as Current.
Click Publish/Republish to make the change live.
🟡 Important:
Setting the start view does not determine the basemap style.
Your selected basemap (e.g. OpenStreetMap, Google Satellite, or Google 3D Tiles) is saved when you publish the project — not when you set the start view.
So, make sure your preferred basemap is selected before you publish.
Why are my items appearing under the map or underground?
This can happen if:
You're using the Google 3D Tiles basemap (which includes elevation and 3D terrain)
The Data Item’s height is set incorrectly
The embedded metadata in the file (like drone images) is inaccurate
To fix it:
Select the Data Item and open the Properties Panel
Go to the Placement tab
Adjust the Height value up or down until the item appears correctly on the map
📝 Tip: If you're working with drone images or 3D models, check the height metadata — sometimes drones record incorrect altitude (e.g., 105m instead of 8m) if not calibrated properly.
Can I select multiple data items in the Sidebar?
At this time, there is no option to select multiple items in the Sidebar.
360 Photos
Can I take measurements in a 360 photo?
Not yet. Swyvl’s measurement tool works on the map, not inside 360 photos.
How do I link 360 photos together to create a tour?
You can link 360 photos using Scatter View or Path View:
Scatter View: Manually connect photos using Edit Pano Connections mode. When you select a 360 Photo on the map, the Edit Pano Connections button will appear in the top right of the Toolbar.
Path View: Upload a GPX file and Swyvl will automatically connect your photos based on GPS data.
Can I add text, annotations, or markers to my 360 photos?
Currently, Swyvl does not support adding annotations directly inside 360 photos.
To add context, you can:
Attach Info Boxes to markers on the map
Use still images, site plans, or draw tools to highlight key areas
Can I set the start view of a 360 photo?
Swyvl does not currently have the option to set the start view of a 360 photo.
Photos
Can I upload regular still photos to the map?
Yes — upload .png or .jpg images using the Photo tool in the Toolbar. Each image can be positioned and styled like any other Data Item.
Floor and Site Plans
Can I add multiple floor plans to a single project?
Yes! You can upload multiple floor plans and stack them at different heights to accurately represent multi-story buildings. Use the height above ground-level setting when configuring each plan.
How do I reposition or resize a site or floor plan?
Open the Properties Panel for the Floor Plan
Go to the Placement tab
Click Reposition.
How do I lock Data Items to a Floor Plan?
To make sure Data Items stay aligned with a specific Floor Plan:
Open the Properties Panel for the Floor Plan
Go to the Placement tab
Enable Clamp points to floor plan
Then, drag the Data Items you want to lock into the Floor Plan folder in the Sidebar (Project Data) section
This ensures the Data Items will maintain consistent height and visibility settings with that Floor Plan.