# Map Styles

* [Base Map Styles](#base-map-styles)
* [Toggle Map Layers](#toggle-map-layers)
  * [Map Layers](#map-layers)
  * [Layer Order](#layer-order)
* [Custom Map Styles](#custom-map-styles)

![map styles](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/f-map-styles-0.png)

kepler.gl provide a set of [Mapbox](https://www.mapbox.com) basemap styles as background map, including 3D buildings! You can also add your own custom map style using the Mapbox style link.

## Base Map Styles

Open the **Base Map panel** to select from a list of default map styles.

![base map panel](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/f-map-styles-1.png)

Open the **base map style** drop down menu to change map color scheme and imagery. Options include:

* **Dark**: dark base map with light-colored text.
* **Light**: light base map with dark-colored text.

## Toggle Map Layers

![map layers](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/f-map-styles-2.png)

#### Map Layers

Hide and show water, buildings, roads, and more. Options include:

* **Labels**: shows labels for cities, neighborhoods, and so on.
* **Roads**: displays a translucent layer of road lines.
* **Borders**: shows state and continent borders.
* **Buildings**: shows building footprints.
* **Water**: displays bodies of water.
* **Land**: Shows parks, mountains, and other landscape features.
* **3d Building**: Shows 3D buildings on the map. 3D buildings are only visible in the 3D map view. Resolution automatically updates based on current map zoom level. Use the input below to edit 3D building color.

![3d building](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/f-map-styles-3.png)

#### Layer Order

To control the order in which map imagery layers are displayed, toggle the move to top icon:

![move to top icon](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/f-map-styles-4.png).

**TIP**: Move labels to the top on maps with colored layers to keep the labels from being concealed.

![Examples of ordered layers](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/f-map-styles-5.png)

## Custom Map Styles

![Add Custom Mapbox Styles button](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image45.png)

To add a custom base map style, click the add map style button to open the custom map style modal, paste in the mapbox [style Url](https://www.mapbox.com/help/studio-manual-publish/#style-url). Note that you need to paste in your [mapbox access token](https://www.mapbox.com/account/) if your style is not [published](https://www.mapbox.com/help/studio-manual-publish/#style-url).

![Add Custom Mapbox Styles popup](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image13.png)

[Back to table of contents](https://docs.kepler.gl/docs/user-guides)


---

# Agent Instructions: 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:

```
GET https://docs.kepler.gl/docs/user-guides/f-map-styles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.