> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.metalocator.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Map Marker Clustering

**Marker clustering** allows multiple map markers located close together to be grouped into a single composite marker, making maps easier to read and navigate.

[![](https://storage.crisp.chat/users/helpdesk/website/-/9/9/4/9/9949d002ab25a800/b1eeacb3-000d-4a8b-aa35-8bc3f8_k0ux9s.png)](https://downloads.intercomcdn.com/i/o/232645925/d08511edadd46ae66dd32e9c/image.png?expires=1794511800&signature=2ef95f56c39dbc41fc355ec0cf47a2e07fdb48ab26e075117b67ed6a14022159&req=diMlEM17lINaFb4f3HP0gJaKjoYLntRh3fKbO18cyCy0Iy5JO65gq6sU8ZLs%0AL8C%2BNE8%2Fq22UQU6qFw%3D%3D%0A)

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**.

[![](https://storage.crisp.chat/users/helpdesk/website/-/c/1/b/e/c1be21ad425cd800/419ac05d-b60a-423e-8a21-37d4a4_1dsmioj.png)](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1715291690/b97001c2b59abfc1a164d51c327d/image.png?expires=1794511800&signature=ecea4697fcabbb8c1c40cda79b314db4991a27c37f4ff7c2e7ba6569fad8bd0e&req=dScmE8t3nIdWWfMW1HO4zbPoqqUOY%2BnWuIq47ANnuj2Zg2mJb%2Bx08lHrd3Yp%0Ag7MvywixLI8y6Kwusjk%3D%0A)

---

## 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.