# Point

In CARTO Builder, the Point layer visualization option allows you to render and style point features on your map. This layer type offers various advanced styling options to enhance the visual representation of your data such as creating heatmap or grid visualizations dynamically from your original source.

<figure><img src="/files/r27kMWxshAva8FgEucij" alt=""><figcaption></figcaption></figure>

## Visualization

You have different visualization options when it comes to point data. Using this functionality, we allow users to dynamically aggregate the original source to:

* [**Grid**](/carto-user-manual/maps/layers/point/grid-point-aggregation.md) : Aggregated geometry into grid cells.
* [**H3**](/carto-user-manual/maps/layers/h3.md): Aggregated geometry into hexagonal bins.
* [**Heatmap**](/carto-user-manual/maps/layers/point/heatmap-point-aggregation.md): Aggregated geometry by density.
* [**Cluster**](/carto-user-manual/maps/layers/point/cluster-point-aggregation.md): Aggregated geometry into circles.

Within the **Advanced visualization options** <img src="/files/KXy7rV4Gu0pLuWqxXqlk" alt="" data-size="line"> , you can access **Zoom Visibility** to define the range at which your layer should be visualized. This ensures that your lines are displayed at appropriate zoom levels, improving the clarity and relevance of your map.

<figure><img src="/files/VAsI5eBC8qgTLO3fTVAW" alt=""><figcaption></figcaption></figure>

If your data source contains identical geometries with varying attributes (e.g., weather stations or buildings), you can use the **Aggregate by geometry** functionality to aggregate your layer based on a distinct spatial column. [Learn more in this section](/carto-user-manual/maps/layers.md#visibility-by-zoom-level-1).

## Symbol

When configuring your point layer symbol, you either use a simple point shape <img src="/files/y5Q6ySJMp3yMEWQQtXLh" alt="" data-size="line"> to render your point layer or you can use a custom marker <img src="/files/NPUotC3XYozBQXbuF8KP" alt="" data-size="line">.

### Custom markers

**Custom markers** allows you to set an icon or an image as a marker in your map, either a single marker or use multiple markers by property. Out-of-the-box options from [Maki icons collection](https://labs.mapbox.com/maki-icons/) is readily available. Additionally, you can upload your own .png or .svg file to be used as marker in the map.

{% hint style="warning" %}
When uploading custom markers, the **maximum allowed resolution is 120×120 pixels** and the **maximum file size is 200K**
{% endhint %}

### Radius / Size

The **Radius** dropdown offers three options in order:

* **Fixed** — a single pixel size, set with a simple slider.
* **Scale with zoom level** — a zoom-dependent size that grows and shrinks with the map zoom (see below).
* **A property from your data** — a radius range driven by a numeric column.

<figure><img src="/files/YY8gBWZ62Ed3wdGWKMbY" alt="" width="303"><figcaption></figcaption></figure>

#### Scale with zoom level

When you pick **Scale with zoom level**, the point radius grows and shrinks with the map zoom — keeping points visually proportional to the map context as the user zooms in and out, instead of staying a constant pixel size.

<figure><img src="/files/6abnZERznC1rce7HSoVg" alt="" width="303"><figcaption></figcaption></figure>

* The radius input label changes to **Base size at zoom level {N}**, where *N* is the map zoom at the moment you enabled the option. The pixel size you choose is the size points will have at that reference zoom; below it points get smaller, above it they get larger. *N* is then locked — to change it, switch back to **Fixed**, zoom to the desired view, and reselect **Scale with zoom level**.
* A **Min / Max bounds** control appears below to clamp the rendered pixel size, so points never become too small to see or too large to be useful.

## Fill

In this section you can define **Color** that will be used to fill your point symbol. You can set a simple color or use a [color schema](/carto-user-manual/maps/layers.md#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="/files/xbiEEq4I7ocdf7XUwwnm" alt=""><figcaption></figcaption></figure>

When configuring either the color based on a property, you can access **Advanced fill options** <img src="/files/KXy7rV4Gu0pLuWqxXqlk" alt="" data-size="line"> to set the [color scale](/carto-user-manual/maps/layers.md#fill-color-2). This allows for a more granular and informative visualization.

## Stroke

The stroke of your line layer can be customized in various ways to suit your visualization needs:

* **Stroke Color**: Set a simple color or use a color schema based on a given property to add depth and meaning to your lines. Additionally, you can adjust the stroke opacity to your desired percentage for better visual effects.
* **Stroke Weight**: Define the stroke weight as either a fixed value or based on a given property. You can modify the stroke weight using a simple slider when set to fixed, or by defining a weight range when configured by a property.

<figure><img src="/files/EvpHu53Z0awxQdDRDLI8" alt=""><figcaption></figcaption></figure>

When configuring either the stroke color or stroke weight based on a property, you can access **Advanced stroke options** <img src="/files/KXy7rV4Gu0pLuWqxXqlk" alt="" data-size="line"> to set the color scale or weight scale. This allows for a more granular and informative visualization.

## Labels

You can add labels for your point layer visualization. It can be either single label or double label. You can style and set the label size as well as configuring the placement of the label.

<figure><img src="/files/Kh61R1YNEGirqlItPIVB" alt=""><figcaption></figcaption></figure>

## Using `_carto_point_density` attribute

When working with point dynamic tiling sources in Builder, points are automatically aggregated for optimal visualization. The closer you zoom into the map, the more granular the view becomes, showing individual points.

In Builder, you can now leverage the automatically added `_carto_point_density` property to style the radius, fill and stroke of your layer based on the number of points aggregated at each visible point.

<figure><img src="/files/j09TIzt1GjtDaNxSJiXH" alt=""><figcaption></figcaption></figure>


---

# 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://docs.carto.com/carto-user-manual/maps/layers/point.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.