---
title: "Map Geo Json"
description: "A geographical map visualization that colors regions based on associated values from your dataset, supporting interactive drilldowns and label customizations."
group: Charts
tags: [Visualization, Chart, Dashboard, Map, GeoJSON, Regional Analysis]
---
import { Aside, Steps } from '@astrojs/starlight/components';
# Map Geo Json
The **Map GeoJSON Chart** displays values across geographical regions by filling areas with colors based on numeric measures.
It uses **GeoJSON map data** to render regions and plot values, offering options for label control, color themes, and interactive drilldowns.
**Use cases:**
- Visualizing **regional or country-level performance metrics**.
- Displaying **distribution of values across a geographical area**.
- Highlighting **high and low-performing regions** using color gradients.
---
## ⚙️ Setup
1. Drag the **Map GeoJSON Chart** widget from the chart library onto your designer workspace.
2. Select the chart.
3. Go to the [Widget Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/) tab in the Configuration panel.
4. Under the Configuration panel tab, select the [Basic Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/#basic) option to access essential settings for the Map GeoJSON Chart.
5. Select the [Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources) from which the chart will fetch its data.
6. Map:
- **[Measure (Value)](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** — Numeric value determining the fill intensity for each region.
- **[Dimension (Region)](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** — Region or location name matching GeoJSON region properties.
7. Optionally add a **Date** field for time-based filtering.
---
## 📊 Basic Configuration
| Configuration Item | Description |
|:---------------------|:-------------|
| **[Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources)** | The data source to query for chart values. |
| **[Measure (Value)](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** | Numeric value used for region coloring. |
| **[Dimension (Region)](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** | Region label to match with GeoJSON region names. |
| **Date Field** (optional) | Enables date-based filtering and drilldown capability. |
---
## 🎨 Chart Customizations
| Category | Options & Description |
|:----------------------------|:-----------------------------------------------------------|
| **[General](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#general)** | Theme, background, and interactivity options. |
| **[Title](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#title)** | Chart title, font, alignment, and visibility settings. |
| **[Sorting](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#sorting)** | Define custom sort order for regions if required. |
| **[Grid](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#grid)** | Configure margins and layout alignment. |
| **Map Options** | Pick between various predefined maps.
| **[Series](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#series-customization)** | Configure label display, label rotation, custom fill colors, no-data color, and highlight color for regions. |
| **[Tooltip](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#tooltip)** | Control tooltip content and formatting when hovering over regions. |
| **Others** | Select **GeoJSON Map Source**, **Region Mapping Field (Region/ISO)**, and whether to **normalize maps** for sub-region adjustments (e.g. Alaska/Hawaii repositioning in US maps). |
---
## 📊 Example Visualization
