The library creates and manages per-zoom-level clusters for large amounts of markers. Google API v3.

Downloads in past


301.0.05 years ago5 years agoMinified + gzip package size for js-marker-clusterer-universal in KB


Please note: This repository is not currently maintained, and is kept for historical purpose only.
Marker Clusterer – A Google Maps JavaScript API utility library
A Google Maps JavaScript API v3 library to create and manage per-zoom-level clusters for large amounts of markers. Analytics
Reference documentation
Migrated from the Google Maps JavaScript API utility libraries on Google Code.


Download or clone markerclusterer.js and images m1.png to m5.png, save images in images folder.
To use your own custom cluster images just name your images m[1-5].png or set the imagePath option to the location and name of your images like this: imagePath: 'customImages/cat' for images cat1.png to cat5.png.

<div id="map-container"><div id="map"></div></div>
<script src="markerclusterer.js"></script>
    function initialize() {
        var center = new google.maps.LatLng(51.5074, 0.1278);

        var map = new google.maps.Map(document.getElementById('map'), {
          zoom: 3,
          center: center,
          mapTypeId: google.maps.MapTypeId.ROADMAP

        var markers = [];
        var marker = new google.maps.Marker({
            position: new google.maps.LatLng(51.5074, 0.1278)

        var options = {
            imagePath: 'images/m'

        var markerCluster = new MarkerClusterer(map, markers, options);

    google.maps.event.addDomListener(window, 'load', initialize);

Live Demos

Marker Clusterer Screenshot
Examples page


Want to contribute? Check out the contributing guide!


Copyright 2014 Google Inc. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.