> For the complete documentation index, see [llms.txt](https://docs.mapeo.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/background-maps.md).

# Background Maps

**Mapeo Mobile** 5.5.0 introduces a new **Map Manager** user interface for importing and managing multiple background maps. The new experimental **Background Maps** feature allows you to add your own custom maps and switch between multiple maps.&#x20;

{% hint style="danger" %}
When this feature is enabled, you will not have access to the map you had previously been using in Mapeo. Turn off Map Manager to switch back to your previous map.&#x20;
{% endhint %}

{% hint style="info" %}
For info on how to generate a map file in for use in the new Background Maps feature, see [Generating map files in .mbtiles format for the experimental Background Maps feature](/complete-reference-guide/customization-options/custom-base-maps/creating-custom-maps/creating-mbtiles.md)
{% endhint %}

{% hint style="warning" %}
Due to Android storage requirements the Map Manager can take up to three times as much storage as the size of the mbtiles you want to import, so be sure to have enough storage on the phone
{% endhint %}

{% hint style="warning" %}
Currently there are issues with loading large mbtiles with the map manager specially on lower-end phones. It's advised to use files with a maximum of 500mb as well as deleting other background maps before adding news ones
{% endhint %}

#### Turn on Background Maps

To activate the Background Maps feature:

1. Click on <img src="/files/IZLMBARj898AxdpBOlDq" alt="" data-size="line"> **Observations List,** then click on <img src="/files/2HoqM2jBItK9l3g6bCSl" alt="" data-size="line"> **Settings** and select **Experiments.**
2. Select **Background Maps**, then click the checkbox to **Use Background Maps**.
3. Click on **Background Maps** below **Try it now** and again on **Background Maps** to enter the map manager.
4. With the generated mbtiles stored on the phone, click on **Add Background Map** and on\ <img src="/files/nEPcgPqO6OSkbkrUj8aF" alt="" data-size="line"> **Import from File** to add an existing mbtiles file to be loaded.
5. A progress bar indicating the file is loading will appear. This could take several minutes depending on the mbtiles file size and the phone's  processing power.
6. Once loading is done, select the new backgroud maps and click on **Use Map** in order to set it as the background map for Mapeo or ![](/files/stgD6ABF3PHIGbQCWI68) **Delete Map** to delete it.
7. On the home screen you can also click on ![](/files/TBbspPVq7wv7Zogf9hqj) **Background Maps**, to choose between the default map or imported custom maps.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/background-maps.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
