Skip to main content
This feature is in beta. Reach out to the Lightdash team if you’d like to get access.
Maps display geographic data on an interactive map. They support three visualization modes: Map types:
  • Scatter - Plot individual points using latitude/longitude coordinates
  • Heatmap - Show density of points as a heat overlay
  • Area (Choropleth) - Color regions based on values
Maps are useful when:
  • Visualizing geographic distribution of data
  • Showing regional performance or metrics
  • Displaying location-based patterns

​
Data requirements

The type of geographic data you have determines which map visualization you can use:
  • Latitude and longitude coordinates - If your data includes lat/lon fields, you can create scatter maps, bubble maps, or heatmaps to plot individual points.
  • Country codes or US state codes - If your data contains standard geographic codes (like ISO country codes or US state abbreviations), you can create choropleth maps using the built-in region shapes.
  • Custom geographic identifiers with GeoJSON - If your data uses other geographic identifiers (like postal codes, sales territories, or custom regions), you can create choropleth maps by providing a custom GeoJSON file that defines the region boundaries.

​
Layout options

Map type - Choose between Scatter, Heatmap, or Area modes. For Scatter/Heatmap:
  • Latitude field - Field containing latitude coordinates
  • Longitude field - Field containing longitude coordinates
For Area (Choropleth):
  • Map region - World, Europe, US, or Custom
  • Custom region - Toggle to use a custom GeoJSON URL
  • Region field - Field containing region names to match
Value field (optional) - Metric to determine color intensity.

​
Display options

Color range:
  • Configure gradient colors (2-5 colors)
  • Low to high color mapping
Legend:
  • Show/hide legend
Background map:
  • None, Light, OpenStreetMap, Dark, Satellite
  • Custom background color (when None selected)
Bubbles (Scatter mode only):
  • Size based on field (optional)
  • Size range slider (min/max bubble size)
Map extent:
  • Save current map extent - Preserves zoom/pan position