Most blue-dot issues come down to one of a handful of things: a switch that's off, a level that isn't calibrated, a skewed overlay, or the device itself. Work down this list and you'll usually find it quickly.
The dot doesn't show at all
| Check | Fix |
|---|---|
| Is the master switch on? | On the GPS tab, tick Enable GPS blue dot (live visitor location). While it's off, no dot ever shows, whatever the per-level settings say. |
| Is the dot enabled for this level? | Expand the level — it should read ● Dot Enabled, not Dot Disabled. |
| Does the level show ✓ GPS set? | A level with no corners can't place a dot. Position it and Capture corners so it reads ✓ GPS set. |
| Did the visitor allow location? | The browser must be granted location access. If it's blocked, turn on Warn when device location is off so visitors are told to enable it. |
| Published since your change? | Hand-typed corner edits need a Save & Publish. (Capturing corners with the tool publishes automatically.) |
The dot shows but sits in the wrong place
This is almost always a calibration problem on that level. Re-open the positioning tool and look closely at the fit.
-
Re-position and zoom right in
Click 📍 Position on map, then zoom the street map in on the building. A fit that looked fine at low zoom can be several metres out up close.
-
Use Distort, not just Resize
If the dot drifts more the further it is from one corner, the overlay is rotated or skewed relative to the real building. Switch to Distort and drag each corner onto its true real-world position.
-
Check the corners aren't swapped
If the dot's movement is mirrored or upside-down, the image was probably placed flipped. Click ↺ Reset to drop a correctly-oriented box and line it up again.
-
Re-capture
Click ✓ Capture corners — it overwrites the old values and publishes straight away.
Visitors see "outside the map area"
This message means the visitor's location is outside every calibrated level. Common causes: they really are outside the mapped building, no level is calibrated for where they are, or a level's corners were captured over the wrong place. Re-check the corners of the levels that should cover that spot. You can turn the message off by unticking Warn when they're outside the map area, though it's usually helpful to leave on.
A dot appears even without a real fix
If a stationary dot sits in the middle of a level regardless of where anyone actually is, Demo mode is on. That's a showcase setting — untick Enable GPS Demo mode, re-enable the real blue dot, and publish. See the Demo mode guide.
The positioning tool won't open or line up
| Symptom | Fix |
|---|---|
| "Add this level's image first" | The level has no map image. Upload one on the Levels tab, then try again. |
| "Couldn't load the map tool" | The street-map tool needs a connection and can be blocked by strict networks or ad-blockers. Try again on a normal connection. |
| Address search finds nothing | Search by a nearby well-known landmark or a simpler address, then drag the overlay the last little way by hand. |
| The overlay ends up twisted or off-screen | Click ↺ Reset to drop a fresh, correctly-proportioned box in the current view and start the fit again. |