---
title: "Creating an MBTile"
slug: "creating-an-mbtile"
updated: 2026-03-11T13:58:30Z
published: 2026-03-11T13:58:30Z
canonical: "docs.avontus.com/creating-an-mbtile"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avontus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating an MBTile

When adding a Map Overlay, the file must be in the MBTile file format. You can create MBTiles using the Maptiler Desktop app which can be downloaded for free here - [https://www.maptiler.com/desktop/](https://www.maptiler.com/desktop/).

Once you have downloaded, the Maptiler application you can convert your image, whether it is a JPEG, PNG, etc, into the correct format.

**Note: In this example, we are using Maptiler Engine. You can use any application you like.**

To do this.

1. Drop your image onto the Maptiler desktop app. **Note: You can also select Open file** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-TVI1HJLV.png)
2. Once you've dragged a file to the Maptiler app, select **Assign Location Visually (GeoReferencer).** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-JYIZ7KY4.png) Two maps will appear, one of them is your image and the other is Maptiler app map.
3. On the map on the left, find your location. You can use the search icon if needed. ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-Y8I003OP.png)
4. Once found, you can change to satellite view to match the two maps up. This will make it easier to match your location. ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-KGMZ7DNY.png)
5. Select **Satellite Hybrid** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-PP3JD62E.png)
6. Click on a point on each map to create the first pair of the pairs of location points. **Note: I will select three pairs of location points, however, you can select more than three location points.** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-PO9YJ0Y9.png)
7. Select the remaining location points. ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-Q4BTDOPF.png)
8. Select **Overlay** to place the two maps on top of each other. ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-95H5XBQ1.png)
9. Once happy, click **Continue** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-U8IM0VAH.png)
10. Click **Continue.** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-BTL4COPU.png)
11. Click **MBTiles** and then select **Continue** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-6SK9ROHT.png)
12. Modify the **Output tile format** and **Zoom** levels.
13. Select **Continue.** **Note: Free users will also need to enable the Non-commerical Use checkbox** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-LYKYLS9L.png)
14. Navigate to the correct folder and save the MBTile file in that folder. ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/f7adabae-e2ad-4f37-8146-465db74d0275.png)
15. Select whether to upload the output to Cloud, and **Continue** ![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-G5GVFL7S.png)

The process will begin. When it is complete it can then be [added to ScaffoldIQ](https://avontus.document360.io/v1/docs/add-mapbox-overlay). ,![](https://cdn.document360.io/ae69c864-58f0-4711-91e1-d1c2f7dff95f/Images/Documentation/image-FW2IBC01.png)