Skip to content
← Back to app/Help Center/map-not-loading
Troubleshooting

Map not loading

Troubleshooting steps when the map panel is blank or doesn't respond.

Symptoms

The map panel is blank (grey or white), shows a spinning loader that never resolves, or loads but doesn't show any pins or layers.

Step 1: Hard refresh

Press Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows) to force a full cache refresh. Sometimes cached JS bundles get out of sync with the map tile assets.

Step 2: Check browser extensions

Ad blockers and privacy extensions (uBlock Origin, Privacy Badger, Ghostery) occasionally block WebGL or tile requests from map providers. Try opening the page in an incognito or private window — extensions are usually disabled there. If the map loads in incognito, one of your extensions is the culprit.

Common extensions that block maps: uBlock in strict mode, some corporate VPN clients, and Disconnect.

Step 3: Check WebGL

Our map (MapLibre GL) requires WebGL to render. To check if WebGL is enabled:

  1. Visit get.webgl.org
  2. If you see a spinning cube, WebGL is working.
  3. If not, your browser may have hardware acceleration disabled. In Chrome: Settings → System → Use hardware acceleration.

Step 4: Try a different browser

We support Chrome, Firefox, Safari, and Edge. If you're using an older browser version or a less-common browser, try Chrome or Firefox.

Step 5: Disable VPN

Some VPNs route traffic through servers that block map tile requests or cause slow TLS. Temporarily disable your VPN and retry.

Still not working?

Please report the issue. Include your browser version, OS, whether you're on a VPN, and any error messages visible in the browser console (F12 → Console tab).

More in Troubleshooting

Was this helpful?

If you didn't find what you were looking for, our support team can help.

Report a bug

Tell us what happened — it helps us improve accuracy fast.

Minimum 10 characters.

Images only (JPEG, PNG, GIF, WebP). Max 10 MB each.

Reports are sent to our internal Asana board and tracked as a GitHub issue. We monitor these closely and address them ASAP. You'll receive updates as we publish changelog releases.

Diagnostics included: App version alpha 41.30.086

We read every report. Thanks for helping us improve.