From c4236ce1e2af474ac3f60408efdd2890ee4846d6 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 16 Dec 2025 14:23:59 +0000
Subject: [PATCH 1/3] Update references/chart-types.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
 references/chart-types.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/references/chart-types.mdx b/references/chart-types.mdx
index b51afea2..02668bec 100644
--- a/references/chart-types.mdx
+++ b/references/chart-types.mdx
@@ -17,6 +17,7 @@ In Lightdash, the data in your results tables can be visualized in a bunch of di
 - [Table](#table)
 - [Big value](#big-value)
  - [Gauge](#gauge)
+- [Map](#map)
 - [Custom chart](/references/custom-charts)
 
 The visualization type that you pick determines how Lightdash shows the data series in your chart. To change how your data is displayed, click **Configure** when you're querying from a table. You have the option to change the chart type in the drop-down:

From 1b32aefe7070c4d944aadc180d9ad085df8a6836 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 16 Dec 2025 14:24:14 +0000
Subject: [PATCH 2/3] Update references/chart-types.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
 references/chart-types.mdx | 58 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/references/chart-types.mdx b/references/chart-types.mdx
index 02668bec..c881a500 100644
--- a/references/chart-types.mdx
+++ b/references/chart-types.mdx
@@ -414,6 +414,64 @@ To use color ranges for your rules, select **Range** under **Conditional Formatt
 
 The color range will use a set of 5 colors mapped across the min and max colors selected in your rule.
 
+### Map
+
+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
+
+#### 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
+
 ### Big value
 
 <Frame>

From 18f3f69af3ebb86fe3504bf7054ce567b86cc3a0 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 16 Dec 2025 18:05:23 +0000
Subject: [PATCH 3/3] Update references/chart-types.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
 references/chart-types.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/references/chart-types.mdx b/references/chart-types.mdx
index c881a500..517d33e3 100644
--- a/references/chart-types.mdx
+++ b/references/chart-types.mdx
@@ -414,7 +414,7 @@ To use color ranges for your rules, select **Range** under **Conditional Formatt
 
 The color range will use a set of 5 colors mapped across the min and max colors selected in your rule.
 
-### Map
+### Map (Beta)
 
 Maps display geographic data on an interactive map. They support three visualization modes: