Start by checking whether the problem affects the map container, the location data, or only one interactive feature. A visible map with no markers requires different checks from a completely empty map.

The map is empty or has no useful height

  • Set a minimum height when using an aspect ratio, or confirm that full-screen height is suitable for the page layout.

  • Make sure the page can load the selected map tiles and Leaflet resources.

  • Check the published page rather than relying only on the editor preview.

  • If several maps are on one page, test each map independently with its own data and settings.

Locations or markers are missing

  • Check that every record contains valid decimal latitude and longitude values in the correct fields.

  • Confirm that the CSV, CMS content, or feed is published and publicly readable.

  • Reset search and filters so no valid records are being hidden.

  • Test with one manual MapMax Item to separate a data-source problem from a map problem.

A custom marker does not appear

Switch temporarily to a built-in marker. If that works, verify the custom SVG file, its published URL, and the source field used for a data-driven marker. Keep the SVG simple and give it a clear shape at the rendered marker size.

Search or filters return unexpected results

Search depends on useful location names. Filters depend on consistent source values; differences in spelling, capitalization, or extra spaces can create separate options. Test the complete unfiltered dataset before diagnosing an individual filter.

The wrong marker or popup is focused

Update MapMax to the current version, especially when clustering is enabled. Then test the same location from the sidebar and directly from its marker. Adjust Popup Focus Offset and initial-view padding if the correct marker is selected but the popup is clipped or covered.

Improve performance with many locations

  • Keep clustering enabled for dense datasets.

  • Optimize popup and sidebar images.

  • Remove unused fields and empty source records.

  • Test a smaller data sample to identify unusually large or malformed entries.

Accessibility checklist

  • Enable a readable sidebar when locations must not be available only as visual map pins.

  • Use clear location names, addresses, and text descriptions.

  • Add meaningful alternative text to location images.

  • Maintain strong contrast for cards, text, controls, and markers.

  • Do not distinguish categories by marker color alone; include a textual label or filter name.

  • Use descriptive labels for information and route actions.

  • Test the location list, search, filters, and buttons with a keyboard and at narrow viewport sizes.

Contact support

If the issue remains, email support@stackswork.com. Include the MapMax version, public page URL, data-source type, browser and device, a screenshot of the relevant settings, and one anonymized example record. Do not send CMS or server login credentials.

For the recommended setup sequence, see Getting started with MapMax.