Docs Menu

Geospatial Customization Options

On this page

  • Custom Color Palette
  • Automatically Set Viewport
  • Opacity
  • Radius
  • Stroke Thickness
  • Tile Server and Attribution Message

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

Geospatial customization tab

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.

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.

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.

You can configure your tile server and attribution message for geospatial charts if you do not wish to use the default options. For instructions, see Configure Geospatial Tile Server and Attribution Message.

Give Feedback
© 2021 MongoDB, Inc.


  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.