Sites & sessions

Sites

A site is a named physical location on the map — a construction site, a mine, a parcel of land, a road corridor. Sites are the top-level organisational unit for your data.

All files in Swyvl belong to a site. There is no workspace-level file inbox.

Creating a site

From the map home screen, click + in the toolbar
Click a location on the map to place the pin, or search for an address
Enter a site name
Drag the pin to the exact location if needed
Click Create

The site appears as a pin on the map. Click it to open the Site Hub.

Site hub

The Site Hub is the main view for a site. It has four tabs:

Tab	What it shows
Files	All uploaded files, grouped by capture session
Timeline	Files over time — how the site has changed
Sharing	Share links for this site
Activity	Upload history, viewer events, and share link activity

Capture sessions

A capture session represents a single field visit — one drone flight, one laser scan day, one photogrammetry run. Sessions group files that were captured together.

Sessions help your clients understand which data came from which visit, and make it easy to compare how a site looks across multiple dates.

Creating a session

Sessions are created when you upload files:

In the upload dialog, open the Session dropdown
Select an existing session, or type a new name to create one
Optionally set a capture date for the session

You can also create sessions from the Files tab before uploading.

In share links, files are automatically grouped by session with the session name and capture date as a heading. This gives clients a clear timeline of deliveries:

Coca-Cola Amatil Site — Survey 2026
  ├── March 2026 Scan        (9 Mar 2026 · 3 deliverables)
  │   ├── site_scan.laz
  │   ├── ortho.tif
  │   └── report.pdf
  └── January 2026 Scan     (14 Jan 2026 · 2 deliverables)
      ├── site_scan_jan.laz
      └── report_jan.pdf

Workspaces

A workspace represents a client. Sites, files, and share links belong to a workspace.

If you work with multiple clients, create a separate workspace for each one:

Workspace A — City of Brisbane
Workspace B — BHP Operations
Workspace C — Coca-Cola Amatil

Each workspace has its own branding (accent colour, header message), sites, and share links. Switch workspaces using the selector at the top of the sidebar.

Organisation

Your organisation is the top level — it represents your company. An organisation contains all your workspaces, and settings like your logo and data region apply across all of them.

Organisation (Lone Star Surveying)
  ├── Workspace: City of Brisbane
  │   ├── Site: Queen Street Mall
  │   └── Site: South Bank Parklands
  └── Workspace: BHP Operations
      ├── Site: Olympic Dam
      └── Site── Caval Ridge Mine