Marker clustering allows multiple map markers located close together to be grouped into a single composite marker, making maps easier to read and navigate.
Clicking a cluster expands it to reveal the individual markers inside, enabling users to visually drill down from a broad view into specific locations.
The settings for this feature can be found under Map Settings → Cluster Map Markers.
Implementation and Recommendations
When to Use Clustering: Enable clustering when your map displays a large number of locations in the same region, as this prevents marker overlap, improves readability, and enhances performance. For maps with only a few dispersed locations, clustering is generally unnecessary.
Settings Configuration: Configure "Open Marker Window on Results Click" for desktop preferences and "Focus Marker" for mobile devices. These options are available under the admin settings.
Map Vendor Compatibility: This feature works with both Google Maps and MapTilerGL, ensuring flexibility across different mapping providers.
Active Marker Clusters
The Active Marker Clusters feature enhances interaction by visually expanding clusters when a user hovers over a corresponding result card. This helps users see which markers belong to a cluster and where they are located, improving map usability.
Cluster Hover Behavior: When hovering over a result card, associated clusters expand smoothly to draw attention, then return to normal size when the hover ends. If the location is not in a cluster, the individual marker highlights as usual.
Result Click Behavior:
Desktop – If "Open Marker Window on Results Click" is enabled, clicking a result pans and zooms to the marker and opens its info window.
Mobile – If "Focus Marker" is enabled, the map pans and zooms to the marker without opening the info window, ensuring a streamlined mobile experience.