diff --git a/website/src/lib/components/layer-control/LayerControlSettings.svelte b/website/src/lib/components/layer-control/LayerControlSettings.svelte
index 699788a7..3290e73a 100644
--- a/website/src/lib/components/layer-control/LayerControlSettings.svelte
+++ b/website/src/lib/components/layer-control/LayerControlSettings.svelte
@@ -140,14 +140,6 @@
- {$_('layers.custom_layers.title')}
-
-
-
-
-
-
- {$_('layers.opacity')}
+
+ {$_('layers.custom_layers.title')}
+
+
+
+
+
+ {$_('layers.heatmap')}
diff --git a/website/src/lib/docs/en/map-controls.mdx b/website/src/lib/docs/en/map-controls.mdx
index 4ff928c5..03221e35 100644
--- a/website/src/lib/docs/en/map-controls.mdx
+++ b/website/src/lib/docs/en/map-controls.mdx
@@ -2,4 +2,58 @@
title: Map controls
---
+
+
# { title }
+
+### Map navigation
+
+The controls at the top allow to zoom in and out , and to change the orientation of the map .
+
+To control the orientation and tilt of the map, you can also drag the map while holding Ctrl.
+
+### Search bar
+
+You can use the search bar to look for an address and navigate to it on the map.
+
+### Locate button
+
+The locate button will center the map on your current location.
+
+
+ This only works if you have allowed your browser and the website to access your location.
+
+
+### Street view
+
+This button can be used to enable the street view mode on the map.
+Depending on the street view source chosen in the [settings](./menu/settings), street view imagery can be accessed differently.
+
+- Mapillary: the street view coverage will appear as green lines on the map. When zoomed in enough, green dots will show the exact locations where street view imagery is available. Hovering over a green dot will the street view image at that location.
+- Google Street View: click on the map to open a new tab with the street view imagery at that location.
+
+### Map layers
+
+The map layers button allows to switch between different basemaps and toggle map overlays.
+
+- **Basemaps** are the background maps that each have a different style and purpose.
+Only one basemap can be displayed at a time.
+- **Overlays** are additional layers that can be displayed on top of the basemap to provide more information.
+
+
+
+A large collection of global and local basemaps and overlays is available in **gpx.studio**.
+They can be enabled in the [map layer settings dialog](./menu/settings).
+
+In these settings, you can also manage the opacity of the overlays.
+
+For advanced users, it is possible to add custom basemaps and overlays by providing WMTS, WMS or Mapbox style JSON URLs.