Documentation version
TroubleshootingApplies to 1.0.0

Map does not load

Work through provider, privacy, browser and layout checks when the map area stays unavailable.

1. Confirm the layout

Make sure the Locator is not intentionally configured as List Only.

2. Check Interaction Privacy Mode

If the map requires visitor activation, select Load Map before diagnosing a provider failure.

3. Verify the provider

Open the Locator and confirm it points to an available provider/profile. For Google Maps, verify the API key and Map ID. For Custom XYZ, verify the tile URL.

4. Inspect browser errors

Use the browser console/network panel to look for blocked scripts, HTTP errors, API authorization messages or Content Security Policy restrictions.

5. Isolate theme conflicts

Test the Locator in a simple full-width page. If it works there but not in a specific builder container, inspect overflow, hidden elements and custom CSS in that layout.