---
title: "Add a basemap from MapTiler to MapTiler Engine | Guides | Map tiling hosting | Data processing"
description: "Learn how to add custom basemaps from MapTiler Cloud to MapTiler Engine."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Add a basemap from MapTiler to MapTiler Engine

MapTiler Engine has a default set of basemaps you can choose from to modify the look of your map preview. However, you’re not limited to these default basemaps as it is possible to add a **custom basemap service**. In this article, we’ll show you how to use MapTiler as a custom basemap service in MapTiler Engine. You can also add a basemap from MapTiler Server, [check it out here](https://docs.maptiler.com/guides/map-tiling-hosting/data-processing/add-a-basemap-from-maptiler-server-to-maptiler-engine).

## Choosing the map from MapTiler

In order to add a custom basemap service to MapTiler Engine, you’ll need the URL of the TileJSON of the map you want to use as the basemap. Getting it from MapTiler is really straightforward. Simply log in to [your MapTiler account](https://cloud.maptiler.com/start) and navigate to the [**Maps** section](https://cloud.maptiler.com/maps/) in the left-hand side menu. Next, choose the map you wish to add to MapTiler Engine. In this example, we’ll use the “Outdoor” map from the set of standard maps available in MapTiler.

![](./file_3dfb686e0f.webp)

After clicking on the thumbnail of the chosen map, you’ll be taken to the page with its details:

![](./file_5b317e12de.webp)

Scroll down to the **Raster tiles** section and copy the URL of the TileJSON with **512x512 raster tiles:**

Note

**The only supported** format of the tiles served from the custom basemap service is **raster images** with **512x512px size**

![](./file_6bb2831bf6.webp)

## Adding the basemap to MapTiler Engine

It’s really easy to add the chosen basemap to MapTiler Engine. Just open any file supported by MapTiler Engine that you’d like to raster and click on the **“Change basemap”** button located in the lower right-hand corner of the application window:

![add\_basemap\_1.png](./10415160716689_809e1dbb1d.webp)

You’ll see the dialog window where you can choose one of the currently available basemaps. Now, paste the TileJSON URL you copied from MapTiler to the text field at the bottom of the window and click the **“Add layer”** button:

![add\_basemap\_2.png](./10415160715537_56f715a812.webp)

If you did all the previous steps correctly, you should see the new basemap available in the list:

![add\_basemap\_3.png](./10415163500433_6e751cd408.webp)

Click on the thumbnail to choose the new basemap. The dialog window will close and you’ll see the basemap change:

![add\_basemap\_4.png](./10415160852753_b4f9bc7cd5.webp)

And that’s it! Now you can preview your map with a custom basemap of your choice. This setting will persist throughout the application lifetime, so the same basemap will be also visible in the preview screen after you render the map:

![add\_basemap\_5.png](./10415163563921_8844102715.webp)

## Creating your own map

Of course, you are not limited to choosing from the standard set of maps that we used in this tutorial. MapTiler offers the Style Editor tool, where you can create your own map style tailored to your specific needs. Follow [this tutorial](https://docs.maptiler.com/guides/map-design/layer-styling) to learn more.

## Useful links

[Add a basemap from MapTiler Server to MapTiler Engine](https://docs.maptiler.com/guides/map-tiling-hosting/data-processing/add-a-basemap-from-maptiler-server-to-maptiler-engine)  
[How to create a map with your own style/design in MapTiler Edit Style](https://docs.maptiler.com/guides/map-design/layer-styling)  
[Maps, Tiles, Data: What are they and how do they differ?](https://docs.maptiler.com/guides/how-maps-work/map-data/)  
[Set the map in your language](https://docs.maptiler.com/guides/map-design/change-language-in-a-map)  
[How to build a map that is easy to read for users from a specific country](https://docs.maptiler.com/guides/map-design/change-language-in-a-map)  
[TileJSON for map tiles](https://docs.maptiler.com/guides/maps-apis/maps-platform/tilejson-for-map-tiles)