Region Mapsedit

Region maps are thematic maps in which boundary vector shapes are colored using a gradient: higher intensity colors indicate larger values, and lower intensity colors indicate smaller values. These are also known as choropleth maps.

Kibana’s out-of-the-box settings do not show a region map in the New Visualization menu. Use Elastic Maps instead, which offers more functionality and is easier to use. If you want to create new region map visualizations, set xpack.maps.showMapVisualizationTypes to true.



To create a region map, you configure an inner join that joins the result of an Elasticsearch terms aggregation and a reference vector file based on a shared key.

Supported aggregationsedit

Region maps support the following aggregations:

Use the key term to join the results to the vector data on the map.


Layer Settingsedit
  • Vector map: select from a list of vector maps. This list includes the maps that are hosted by the © Elastic Maps Service, as well as your self-hosted layers that are configured in the config/kibana.yml file. To learn more about how to configure Kibana to make self-hosted layers available, see the regionmap settings documentation. You can also explore and preview vector layers available in Elastic Maps Service at
  • Join field: this is the property from the selected vector map that will be used to join on the terms in your terms-aggregation. When terms cannot be joined to any of the shapes in the vector layer because there is no exact match in the vector layer, Kibana will display a warning. To turn of these warnings, go to Management/Kibana/Advanced Settings and set visualization:regionmap:showWarnings to false.
Style Settingsedit
  • Color Schema: the color range used to color the shapes.
Basic Settingsedit
  • Legend Position: the location on the screen where the legend should be rendered.
  • Show Tooltip: indicates whether a tooltip should be displayed when hovering over a shape..