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.



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.



Select any of the supported Metric or Sibling Pipeline Aggregations.


Configure a Terms aggregation. The term is the key that is used 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..