Troubleshooting

Common issues and their solutions to help you get your maps working perfectly.

Map Not Displaying

Blank/Grey Map Area

If you see an empty grey box where the map should be:

1. Check Elementor is active
   • Navigate to Plugins → Installed Plugins
   • Ensure “Elementor” is activated
   • Plugin requires Elementor 3.0.0 or higher
2. Clear browser cache
   • Hard refresh: Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
   • Clear browser cache completely
3. Check for JavaScript errors
   • Open browser console (F12 → Console tab)
   • Look for errors related to Leaflet or LMFE
   • Resolve conflicts with other plugins
4. Verify Leaflet is loading
   • Check browser Network tab for leaflet.js
   • Should load from plugin’s assets folder
   • Check for 404 errors

Map Not Responsive

If map doesn’t adapt to screen size:

• Use percentage or vh units for height
• Check Elementor column width settings
• Test on actual devices, not just browser resize

Locations Not Showing

Manual Mode – No Markers Visible

1. Verify coordinates are entered
   • Check latitude/longitude values are present
   • Ensure lat is between -90 and 90
   • Ensure lng is between -180 and 180
2. Check zoom level
   • Map might be too zoomed out
   • Try zoom level 13 for city-level view
3. Inspect map center
   • Map center should be near your markers
   • Auto-center may not work with invalid coordinates

Dynamic Mode (Pro) – No Markers Visible

1. Check field mapping
   • Verify latitude/longitude field names are correct
   • Field names are case-sensitive
   • Check for typos
2. Verify posts have coordinates
   • Edit a location post
   • Confirm metabox has lat/lng values
   • Save post after setting coordinates
3. Check query settings
   • Ensure “Posts Per Page” isn’t set to 0
   • Check Include/Exclude filters
   • Verify post status is “publish”
4. Inspect browser console
   • Look for AJAX errors
   • Check if location data is being fetched
   • Verify JSON format is valid

Geocoding Issues (Pro)

Address Search Returns No Results

• Use more specific addresses – Include city, state, country
• Try postcodes – Most accurate for geocoding
• Check internet connection – Nominatim requires online access
• Wait between searches – Nominatim limits to 1 request/second
• Try alternative search terms – Use landmarks or full addresses

Autocomplete Not Working

• Type at least 3 characters before suggestions appear
• Wait 500ms after typing (debounce delay)
• Check browser console for API errors
• Verify Nominatim API is accessible from your server

“Too Many Requests” Error

Nominatim enforces a 1 request per second limit:

• Wait 1-2 seconds between searches
• Results are cached for 24 hours
• Avoid rapid autocomplete typing

Performance Issues

Map Loads Slowly

1. Enable marker clustering – Reduces rendering overhead
2. Limit number of markers – Use “Posts Per Page” to cap at 50-100
3. Optimize images – Compress popup images
4. Use caching plugin – Cache Elementor pages

Map Conflicts with Other Plugins

If another plugin also uses Leaflet or OpenStreetMap:

1. Check for JavaScript console errors
2. Try deactivating other map plugins temporarily
3. Plugin uses unique handles to avoid conflicts
4. Contact support if conflicts persist

Editor Preview Issues (Pro)

Map Not Updating in Elementor Editor

• Save and refresh the page
• Check browser console for errors
• Clear Elementor cache: Tools → Regenerate Files
• Ensure editor preview assets are loading

Custom Pin Colors Not Showing in Editor

This is normal – custom colors only appear on frontend after publishing. The editor shows default markers.

Getting Further Help

Before Contacting Support

Gather this information:

• WordPress version
• PHP version
• Elementor version
• Plugin version (Free or Pro)
• Browser console errors (screenshot)
• Steps to reproduce the issue

Support Channels

• Free Version: WordPress.org Support Forum
• Pro Version: ThemeCanvas Support Portal
• Documentation: Online Docs