# Cluster point aggregation

Cluster point aggregation allows you to dynamically group and display your point data as clusters, even when working with large-scale datasets. This type of visualization is ideal for simplifying complex data, identifying concentration patterns, and gaining insights by visualizing data density in a more digestible format.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-0a81caf59fa165ac8d9e664af0d80fb673fb0cd0%2Fcluster.gif?alt=media" alt=""><figcaption></figcaption></figure>

## Visualization

In the Visualization section you can specify the Opacity setting at layer source. Additionally, within the **Advanced visualization options** <img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-0284a6e8c3b0d674f33e4bac8912e003925dd056%2Fimage.png?alt=media" alt="" data-size="line"> , you can access **Zoom Visibility** to define the range at which your layer should be visualized.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-326ae4b6915cf4408d531f46ce1ef2c4b25ca969%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Symbol

In this section, you can define the cluster radius range and adjust the symbol’s aggregation size. This allows you to control the level of detail in the clustering—lower values result in more detailed, granular clusters.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-bc104b24dfe42a19a7f098714a03dc6dff0328af%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Fill

Define the **Color** that will be used to fill your cluster. You can set a simple color or use a [color schema](https://docs.carto.com/carto-user-manual/maps/layers/..#fill-color) based on a given property to add depth and meaning to your lines. Additionally, you can adjust the fill opacity to your desired percentage for better visual effects.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-2fee97aa98ecbfb7a79403fe22badabcbc6251d5%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

When configuring either the color based on a property, you can access **Advanced fill options** <img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-0284a6e8c3b0d674f33e4bac8912e003925dd056%2Fimage.png?alt=media" alt="" data-size="line"> to set the [color scale](https://docs.carto.com/carto-user-manual/maps/layers/..#fill-color-2). This allows for a more granular and informative visualization.

## Stroke

In the Stroke section, you can customize the stroke color and adjust its opacity. Additionally, you can set the stroke weight to match your visualization needs.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-3bc85155144a8061bdb737ad98e45f2564e8c01f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Label

Labels for cluster layers allow you to display the number of aggregated points within each cluster. You can customize both the text color and the halo (outline) color to fit your visualization needs.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-6892133fd667fb565fe6fd5be82731d37f4f4ec1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
