> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/tools/map-editor.md).

# Map Editor

<figure><img src="/files/S5ER7WrzmLPUBeLyfK8w" alt=""><figcaption></figcaption></figure>

The **Maps** feature in Gaio allows you to create geographic visualizations directly within your data flow. It's ideal for displaying regional information, territory segmentation, delivery routes, or indicator distribution by location.

***

## How to Use the Map Editor

***

### **1.**  Access the Maps Module

* In the left-hand panel, go to **Maps**.
* to create a new map, click the plus button

***

### 2. Initial Setup (Settings Tab)

* **Title**: Enter the name of the map (e.g., Brazil, Sales Distribution).
* **Description** *(optional)*: Add context or usage notes for the map.

***

### 3. Map Visualization

* The editor uses **MapLibre** based on **OpenStreetMap**.
* You can **pan**, **zoom**, and **interact** with the map directly.
* In this environment there are two possibilities:
  1. Create a new map by drawing the polygons, line or point.
  2. Load GeoJSON, JSON maps.
* Add polygons, points, or custom areas using drawing tools.
* Useful for highlighting zones of interest, operational regions, or business-driven geographical boundaries.
* Highlighted areas represent selected regions like **states**, **cities**, or **custom zones**.

### 4. Drawings Tab

* Use drawing tools to change or delete you Highlighted areas.

### 5. Use the Top Toolbar

The top-left bar provides tools to:

* **Show Uploader**
* **Download**
* **Delete selected shape**
* **Combined shapes**
* **Separate combined shapes**
* **Public**

### 6. Save and Publish

* Click **Save** (orange button in the top-right) to store your map.
* The map can now be used in:
  * **Dashboards**
  * **Content elements** inside Gaio

***

### &#x20;Strategic Usage Tips

* Combine maps with regional datasets (e.g. sales, customer distribution, social indicators).
* Use drawing tools to define:
  * **Delivery zones**
  * **Sales territories**
  * **Risk or performance zones**
* Maps are fully responsive and ideal for both **operational dashboards** and **executive presentations**.