Skip to content
Snippets Groups Projects
custom-maps.md 1.63 KiB
Newer Older
title: Custom maps
redirect_from:
  - /docs/latest/administration-guide/20-custom-maps
# Custom maps

By default, Metabase uses OpenStreetMaps for map visualizations, but there are a few customization options.

## Finding Map Settings

To find the map settings:

1. At the top right of the screen, click  **gear** icon  >  **Admin settings**.
2. Select `Maps` from the navigation on the left.

![Map Settings](images/MapSettings.png)

## Map Tile Server
As mentioned above, Metabase uses the OpenStreetMaps tile server. However, if your organization requires a different
look or level of detail in your map visualizations, you can change the map tile server by adding the map tile server
path to the first field on the page. The path must either be a URL that starts with "http://" or "https://" or a
relative path to a local file in the JVM's classpath.
## Custom Region Maps
If you need a map that focuses on a specific region, you may want to upload a custom GeoJSON map.

To get started, click the `Add a map` button. A modal will appear, asking for:

 * The name of the map
 * The URL of the GeoJSON file
 * The JSON property that Metabase should use as your region's identifier (a distinct way of identifying this specific region map)
 * The JSON property that Metabase should use as the display name (how the name of the region map appears in the user interface)

If you do not currently have a GeoJSON file, there are many tools available to create one, such as
[MapShaper](https://mapshaper.org/) or [GeoJSON.io](http://geojson.io/). If you're just interested in reading more about
GeoJSON, we recommend that you start [here](https://geojson.org/).