# Clustering

### Feature Clustering

Different kinds of Location Styles (Circle, Marker, Label & Icon) will not cluster together. To enable clustering for the types of locations you've added, **please make sure you select the correct type of clustering**.

### Cluster by Category <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

Cluster by Category allows you to break up clusters into totally different groups depending on the categories of the Locations you've added. You'll want to make sure that Locations are exclusive -- otherwise, the system won't know which cluster to assign a Location to.

Select the **Categories to Cluster.** Categories you don't select will still be broken into individual features on the map. *Please note: currently this only works with Marker type locations.*

Then, you can give the color for these clusters in the text box below. You need to enter a different hex code on each line, in the same order as the categories you selected above.&#x20;

```
#FFFFFF
#1b6a3d
#000000
```

The clusters will be the same color regardless of how many features are in the cluster.

### Cluster Coloring & Sizing <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

Cluster Options allow you to change styling information, in close detail, on your map. This applies globally -- ie, *all* clusters on the map will be styled the same way. Clusters are broken into three sizes: **Small, Medium**, and **Large**.

For each of these cluster sizes, you can define the **color**, the "**count**" that defines how many points means a given cluster is Small, Medium, or Large, the **border color**, and the **border width**. This allows you to make clusters really work with your overall style and layout.

### Image on Cluster <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

Add an image for your cluster instead of the default coloured circle. The image should not be more than 150x150 pixels in size. The number associated with the cluster will still appear in the middle of the image.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wpmaps-docs.mapster.me/maps/clustering.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.