How to edit and export a map style: Advanced customization

The easiest way to change the map design is to use the Customize tool. It is able to change colors of any layer, switch language, or labels fonts.

How to edit a map style

It is not possible to upload a style.json file generated in Mapbox as a style in MapTiler Cloud. If you do this you will get a message about an invalid style.json file. It is caused by the difference in the data scheme between MapTiler and Mapbox. We recommend using the built-in MapTiler Cloud Editor for re-creating the styles.

However, if you want to do more complex changes like hiding a point of interest, defining an exact color for each road type, or adding your own data to the map, you need a more complex tool. It is available in MapTiler Cloud administration after you sign in, click on Maps and select any of them. Click on three vertical dots and select Edit a copy. This will open the MapTiler Edit style tool.

MapTiler Cloud administration with Edit a copy

Change map design, working with layers

The same thematic features are grouped into Layers. Each layer has its own parameters such as color, size, feature type, visibility, and more. Layers are listed in the left side panel in the Edit style tool under the Layers tab. By clicking on each layer, you will see information about the layer and change the attributes

The number of layers and what is included depends on what base map you start to edit. Each map style contains different data, which are mostly based on OpenStreetMap. You can add another layer with the button “add layer” on top.

By hovering a mouse over the layer, you can delete the layer, create a duplicate or make it invisible. By drag and drop, you can also shuffle layers order, which will have an effect on the final map.

MapTiler Edit style tool

Edit layer

Find and change of layer is simple. To start find the layer in a left bar or click on the feature in the map (1). Properties of the selected layer will be displayed next to the sidebar. There are a few base features same for each layer - id, symbol, sources, min zoom, max zoom. Min zoom and max zoom define the visibility of a layer (2).

The filter defines filtering on a thematic layer. For the layer’s definition, classes and attributes see OpenMapTiles Schema.

At least you need to set or edit how to layer will be a draw (3). For example colors, font size, line size. It can be also set dynamically with zoom options.

MapTiler Edit style tool

Inspect the map to learn more about what can be changed

In the top right corner, you can switch between Inspect mode and Map mode. The Map mode shows the map as it will look after being saved. By hovering a mouse over a map element in the Inspect mode you will get all information about attributes of the selected map element, which you can use for map design.

MapTiler Edit style tool in Inspect mode

Add custom geodata to create your own map

To add custom geodata to your map, they need to be first uploaded to MapTiler Cloud. This can be done in the administration by clicking on Datasets -> New dataset. The supported format is MBTiles with raster tiles in PNG or JPG. You can turn an image into MBTiles using MapTiler Desktop.

Once uploaded, they become available from Sources in the top right corner in the Edit style tool. By clicking on any available source, they will move to Active sources. When you have all the desired sources activated, close the window. Now you need to add to layers by clicking on Add Layer in the top left corner. Write down the layer ID (how do you like to call this layer in the Layers menu), select a Type (in case of MBTiles from MapTiler Desktop it is Raster) and Source(which is the name of the source with a “+” sign on the beginning in case of our own layer).

Now you have your own layer activated and work with it as with any other.

MapTiler Edit style tool with own data

Use JSON style definition to write your own map style

All adjustments can also be done using JSON format. The JSON editor is available at the bottom of the Layer tab.

You can also upload your own map style in JSON format. This can be done in the MapTiler Cloud administration by clicking on the Maps -> New Map -> Upload own style.

MapTiler Edit style tool with JSON editor

Save your edits and publish them

When you are happy with your changes, click on the Save button in the top right corner. Your changes are now saved.

In the MapTiler Cloud administration, you can now click on the map and either click on the three vertical dots to Edit style again or to Publish your map into the production environment. If you deploy the map, all services we offer you will be automatically available for your map as well.

Publish your map to get all services available

How to export your custom style as a style.json file

Do you want to keep your custom style in your local storage? Do you want to use it somewhere else? Or do you want to use it for styling your maps in MapTiler Server? In case any of these scenarios are valid, you can export your custom style as a style.json file directly from MapTiler Cloud.

Just go to your "My maps" section at MapTiler Cloud - Maps, click the "three dots" symbol
and select "Export style". The download will start immediately.

Useful links

MapTiler Cloud Start Page
JSON explained