Geospatial Customization Options

To access the available customizations for any chart, click the Customization tab above the encoding channels in the Chart Builder.

Geospatial customization tab

Custom Color Palette

The color palette specifies the range of colors that corresponds to relative aggregated values in your map.

Geospatial Scatter charts use a discrete color picker, and Geospatial Heatmap and Choropleth charts use a gradient color picker, but the mechanism to enable customization is the same. To enable palette customization, toggle the Custom Color Palette switch in the General Customization section.

For more information, see Color Palette Customization.

Automatically Set Viewport

By default, geospatial charts show a map which includes all the data point markers in your specified collection. You can pan and zoom to change the map view, but if you close the chart and re-open it the map reverts to its default state. This behavior is controlled by the Automatically Set Viewport option.

When you toggle the Automatically Set Viewport switch to Off, the area and zoom level at which the map is saved becomes the new default view.


You can pan and zoom the map area in a chart on a dashboard, but these changes do not affect the default map view.


The Opacity level of a map modifies the degree to which the chart’s map data shows through the data point markers. This setting is available on all geospatial charts.

On Geospatial Heatmap and Choropleth charts, the Opacity level defaults to 100%. On Geospatial Scatter charts, it defaults to 20%.


The radius customization option dictates the size of the data markers in Geospatial Heatmaps. The color of each data marker reflects the aggregated value of all data points within that marker’s radius. Radius is measured in pixels, and defaults to 30.


If ten data points exist within the specified radius, the color displayed is based on the aggregated value of those ten data points.

Stroke Thickness

Scatter charts provide the customization option to set the Stroke Thickness, measured in pixels, of the map’s data point markers. This setting defaults to 2.