Skip To Content

Configure clustering

If your map has a layer with a large number of points, you can configure clustering to make it easier to visually extract meaningful information from your data. When you enable clustering, Map Viewer groups point features that are within a certain distance of one another on screen into one symbol.


Clustering is supported for up to 50,000 features in a layer.

Clustering is applied dynamically at multiple scales, which means that as you zoom out, more points are aggregated into fewer groups, while zooming in creates more cluster groups. When you zoom to a level where the clustering area around one point feature no longer contains any other features, that feature is not clustered but instead is displayed as a single point feature with the styling options applied to the layer. You can adjust the number of point features grouped into clusters using the slider provided. Specifying more clustering groups a greater number of features into a cluster, while each cluster contains fewer features when you apply less clustering.

When you enable clustering on a point layer, you can enable clustering pop-ups to display when you click a cluster on the map. The default clustering pop-up contains information about the clusters, including the number of features in each cluster. You also have the option of customizing the clustering pop-up as needed. Clicking any unclustered point features displays the feature pop-up you configured on the layer.

Configure clustering on a point layer

To configure clustering on a point layer, do the following:

  1. Open the map with the point layer in Map Viewer.
  2. Click Details and click Contents.
  3. Browse to the point layer, click the More Options button More Options, and click Clustering.

    You will only see this option for supported point layers.

  4. Check the Enable Clustering box.
  5. Use the slider to specify how many features you want grouped into a cluster.
  6. Optionally customize the pop-ups as needed.
  7. Click OK in the Clustering pane.

    Show the legend to see the number of features in each cluster.

Configure clustering pop-ups

You can enable clustering pop-ups when you enable clustering on a point layer. Once enabled, clustering pop-ups are displayed with a default configuration that includes the number of features the cluster. The additional information displayed in the clustering pop-ups depends on the style applied to the layer. For example, if the Predominant Category style is applied, the default clustering pop-up includes the value of the predominant attribute for each cluster. You can customize the clustering pop-ups to suit your needs.

When you enable clustering pop-ups, pop-ups are automatically enabled for the individual features in the layer. Conversely, clustering pop-ups are enabled automatically when feature pop-ups are enabled.

  1. Follow the steps to enable and configure clustering on the point layer.
  2. In the Clustering pane, click Configure Clustering Pop-up.
  3. Check the Show Pop-ups box.

    Pop-ups are enabled for clusters and individual features in the layer.

  4. Enter a title for your pop-up. Use the [+] button to select fields from your data and enter static text instead of or in addition to your field values.
  5. Select a display option for the pop-up. Your choices are a list of field attributes or a custom attribute display.
  6. Do one of the following:
    • If you chose to display a list of field attributes in the previous step, click Configure Attributes and select the fields you want to display. You can also select a field to change its alias, change its order, or format it. For number fields (such as population), select the number of decimal places to display and whether to use a 1,000 separator. Click OK when finished.
    • If you selected a custom attribute display, click Configure to define and format the information you want to show. The custom attribute display allows you to use a combination of rich text, attributes, and links to give you the most control and flexibility over your display. Use the [+] button to insert the clustering attributes you want to include, or accept the default configuration. Click OK when finished.

      The default clustering pop-up configuration depends on the style applied to the layer. For example, in addition to including the number of features in the cluster, clustering pop-ups might show the value of the predominant attribute or the average value of the attribute used to style the layer.

  7. Click OK in the Configure Clustering Pop-up pane.
  8. View your clustering pop-ups by clicking the clusters on the map. To learn more about individual features in a cluster, click Browse Features at the bottom of the pop-up and click the forward and back arrows at the top to scroll through information for each feature. To go back to the summary information for the cluster, click View Summary.


  • Clustering is supported on hosted point feature layers, ArcGIS Server 10.3.1 and later point feature layers, CSV layers, and feature collections.
  • Clustering is not supported on multipoint feature layers.
  • Clustering is only supported for up to 50,000 features in a layer.
  • The Heat Map style is not supported for layers with clustering enabled.
  • Publishing hosted tile layers from hosted feature layers is not supported for layers with clustering enabled.
  • To configure clustering on a point layer, the map must be in the WGS 84 or Web Mercator coordinate system.
  • Clustering is disabled during an edit session.
  • Labels are not available for clustered features.