Insights - How-to build a map widget

Updated 2 years ago by Elena Yurkova

Scatter Map

Scatter Maps allow you to visualize geographical data as data points on a map. The map distinguishes data using different colors and sizes for the data points on the map.

Widget Designer


In the Location panel, you can add any field(s) that contain geographic data, and the map will find the most appropriate point. Supported Location types:

  • Country
  • City
  • State/Province
  • Latitude/Longitude (for example: 37.5601, -122.50131, but not 37.5601° N, 122.50131° W).

To define the location type click on the geographic field’s menu will present a location type sub-menu, which contains the following options:

By default, Auto is always selected. This option tries to figure out which fits best. For better accuracy, you can specify the appropriate location type.

For example, if you have a country field, using it by itself will visualize the countries on the map:

If instead you prefer to group by city, add multiple location levels to visualize the cities on the map:

Use multiple geographic fields to improve geographic accuracy.

To improve accuracy, it is recommended to use more than one geographic level. For example, if you have both a country and a city field, add both of them to the Location panel as on the screenshot above.

To visualize latitude and longitude data, you have to add one field containing latitude data, and another field containing longitude data, in this order.

Select a numeric field here to color the scatter points on the map according to their value and color rule.

The value of the field is displayed in the tooltip of the scatter point on the map. Hover over the point to see it.


Select a numeric field here to make the size of the scatter points on the map relative to their value in the field’s value range.


You can select additional data (numeric or descriptive) that will appear when hovering over the data point in the map:

Design Tab

Go to the top right corner of the widget designer to fine-tune the appearance of the Scatter Map. Design tab for this widget type offers the following tools.

  • Marker Style: Choose between various marker styles.
  • Marker Size: Select the relative size for the markers.
    When the Size has a field in it, the slider has two levers controlling the minimum and maximum size of the points:

How did we do?