3D backgrounds

Upload a GLB model and place surface points

For pro Updated 2 October 2026

Where

Map then Backgrounds

Use a self-contained 3D site model as an interactive project background.

Steps

  1. Export a GLB 2.0 file with visible geometry and embedded textures and geometry.
  2. Keep the file under 50 MB and avoid required Draco, Meshopt or KTX compression.
  3. Upload it as a background and wait for the model to load.
  4. Choose an existing point under Add points and click a visible model surface.
  5. Drag an existing marker onto another surface if it needs moving, then review and publish.

Expected result

Markers are stored at positions on the model and share the project’s point data and popups.

Alternatively, use Geometry beside 3D settings to link named model objects directly to existing points. See Link model geometry to points. This does not require duplicating the point or removing existing markers.

Tips and limits

External texture URLs and unsupported compressed extensions are rejected. Google Map satellite imagery is a different background type. GLB supports point placement, not editable surface polygons. Optimise large models and baked textures for the intended device.

Effect on the published viewer

Publish the model background and placements to update the public viewer.

Still need a hand?

Send us the project name, what you were doing and any error you saw. We'll get back to you.