# Añadir mapas de fondo personalizados a Mapeo Desktop

By default, Mapeo Desktop in **Observations** mode uses a[ background map](/espanol/guia-de-referencia-completa/will-mapeo-work-out-of-the-box-for-me/default-base-map.md) that shows some geographical elements such as rivers and hills, as well as some political and urban elements such as borders, cities, roads, etc. Mapeo Desktop in **Territory** mode offers a range of background maps including satellite imagery, OpenStreetMap, and more.

If you have a [custom background map](/espanol/guia-de-referencia-completa/customization-options/custom-base-maps.md), you can add it and use it in Mapeo Desktop without affecting the data collected. (For more on creating custom background maps, see [Mapas de fondo personalizados](/espanol/guia-de-referencia-completa/customization-options/custom-base-maps.md).)

{% hint style="danger" %}
Adding a background map to Mapeo Desktop requires some technical skills and should be done by someone comfortable copying and pasting files within the internal file system. A mistake in this process could cause irreversible undesired effects.
{% endhint %}

To add a background map to Mapeo Desktop, follow the instructions below for your operating system:

* <img src="/files/RsKa6yTPy727EcUQeEmb" alt="" data-size="line"> [**Windows computer**](#steps-for-a-windows-computer)
* <img src="/files/qoLM7oIcoAYznM59EiWO" alt="" data-size="line"> [**macOS computer**](#steps-for-a-macos-computer)

## Windows computer

### Locate and copy the contents of the Mapeo background map package&#x20;

Mapeo background maps will often be shared as a compressed file`(.zip)`. If your background map is a `.zip` file, double click the file to unzip it.

Standard vector background maps for Mapeo will contain the file elements listed below: 3 folders and 2 files.

![](/files/hxIJjWH7IHa0xFOYMaoT)

{% hint style="info" %}
Raster background maps will contain different files and folders than those pictured above. Raster maps for Mapeo consist of one folder (`tiles`) and one file (`style.json`).
{% endhint %}

Select and copy all of the elements found inside your background map folder.

### Paste the copied elements into the Mapeo/styles/default folder

1. In the Windows search engine, type `%APPDATA%` , and open the folder that appears with this name.&#x20;
2. Inside the **AppData** folder, click on the **Mapeo** subfolder, then click on the **styles** subfolder.
3. If there is not already a **default** folder inside your **styles** folder, you will need to create one. To do so, right-click inside the **styles** folder and create a new folder named **default.**&#x20;
4. Paste the background map elements you copied into the **default** folder.

### Reload **Mapeo Desktop**

Use **Ctrl + R** on your keyboard to reload Mapeo or restart <img src="/files/J7DJz0EhOaiOgQRUbNm6" alt="" data-size="line"> **Mapeo Desktop** to begin using the custom background map.

{% hint style="info" %}
For more on loading custom background maps into **Territory** mode in Mapeo Desktop, see [Cambiar mapas de fondo en el modo Territorio](/espanol/guia-de-referencia-completa/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information/changing-basemaps.md) in the [Mapeo Desktop para la creación de datos territoriales (modo Territorio)](/espanol/guia-de-referencia-completa/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information.md) section.
{% endhint %}

## macOS computer

### Locate and copy the contents of the Mapeo background map package&#x20;

Mapeo background maps will often be shared as a compressed file`(.zip)`. If your background map is a `.zip` file, double click the file to unzip it.

A Mapeo background map consists of several folders and files that need to be copied into the file system of Mapeo Desktop. Standard vector background maps for Mapeo will contain the file elements listed below - 3 folders and 2 files.

![](/files/hxIJjWH7IHa0xFOYMaoT)

{% hint style="info" %}
Raster background maps will contain different files and folders than those pictured above. Raster maps for Mapeo consist of one folder (`tiles`) and one file (`style.json`).
{% endhint %}

Select and copy all of the elements found inside your background map folder.

### Navigate to the Mapeo/styles folder

1. Click on **Finder** on your computer.
2. In the top menu bar, click on **Go**, then select **Go to Folder...**
3. Type in `~/Library/Application Support/Mapeo/styles` in the address bar and click on **Go**.

### Paste the copied elements into the Mapeo/styles/default folder

If there is not already a **default** folder inside your **styles** folder, you will need to create one. To do so, control-click inside the **styles** folder and create a new folder named **default.**

Paste the background map elements you copied into the **default** folder.

### Restart **Mapeo Desktop**

Use **Command (⌘)-R** on your keyboard to reload Mapeo or restart <img src="/files/J7DJz0EhOaiOgQRUbNm6" alt="" data-size="line"> **Mapeo Desktop** to begin using the custom background map.

{% hint style="info" %}
For more on loading custom background maps into **Territory** mode in Mapeo Desktop, see [Cambiar mapas de fondo en el modo Territorio](/espanol/guia-de-referencia-completa/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information/changing-basemaps.md) in the [Mapeo Desktop para la creación de datos territoriales (modo Territorio)](/espanol/guia-de-referencia-completa/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information.md) section.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mapeo.app/espanol/guia-de-referencia-completa/mapeo-desktop-installation-setup/adding-custom-base-maps-to-mapeo-desktop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
