> For the complete documentation index, see [llms.txt](https://docs.woohoo.dance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.woohoo.dance/ajax-filters/woohoo-map/troubleshooting.md).

# Troubleshooting

#### Map Not Showing

* ✓ Check API key in Settings → Woohoo Filters
* ✓ Enable Maps JavaScript API in Google Cloud Console
* ✓ Check browser console for errors

#### Markers Not Appearing (Dynamic Mode)

* ✓ Verify field names match ACF/meta field names exactly
* ✓ Check lat/lng values are numeric
* ✓ If using address, enable Geocoding API

#### Dynamic-Sync Not Updating

* ✓ Query names match exactly (Main Query & Map element)
* ✓ Woohoo Map Connector present in card template
* ✓ Connector fields mapped to dynamic data

#### Custom Markers Not Showing

* ✓ Image uploaded and URL valid
* ✓ Dynamic property path set for dynamic fields
* ✓ Check browser network tab for 404 errors