Kepler.gl is a powerful open source geospatial analysis tool for large-scale data sets.
Interactions
You can toggle customization options on your map, including tooltips, brush highlighting, map imagery (water, parks, etc.), and more.

To toggle customization options on your map:
Open the Interactions menu by clicking the Interactions icon:
Click the switch next to the options you wish to activate/deactivate.
Alongside Tooltip, Brushing, and Coordinate, use Bookmarks to return to saved map views and Fade on Zoom to control visibility by zoom level. Only one of tooltip and brushing can be on at a time.
Tooltips
tooltip displays metrics when hovering over a data point. You can choose which fields are displayed from the tooltip config menu.

- Image Image can be added to tooltip. If field name contains
<img>and the field content containshttpurl
| id | <img>-tooltip |
|---|---|
| 1 | http://my-image.com/my-image-0.png |
| 2 | http://my-image.com/my-image-1.png |
- Web link
Tooltip can be a clickable weblink. To add a web link as tooltip, add a url that starts with
http://to the field content.

Tip: click a point to pin the tooltip info to the map. To unpin the tooltip, press the blue pin icon.

Brushing
- Brush: Brush allows you to highlight areas with the cursor. When brush is turned on, all layers darken. Only the portion you hover over with the cursor is illuminated. Brush works well with arc layers in particular.

Display Coordinates

When then on coordinate, a panel contains latitude and longitude will follow your mouse
Bookmarks
Bookmarks save the map center, zoom, bearing (rotation), and pitch (tilt). They change the camera view without restoring a separate set of layers, filters, or data. You can create bookmarks even before adding a dataset.
Capture and manage views
- Open Interactions → Bookmarks by clicking its header.
- Pan, zoom, rotate, and tilt the map to compose a view, then click + Add Bookmark.
- Edit the name directly in the bookmark's header.
Hover over a bookmark header to reveal its controls, or use Tab to reach them with the keyboard:
| Control | Action |
|---|---|
| Go to | Smoothly move the map to the saved view. Bookmarks must be enabled. |
| Copy coordinates | Copy the saved center as latitude, longitude in decimal degrees, rounded to six decimal places. Copying does not move the map. Successful copying is silent; a failure displays a message. |
| Update view | Replace this bookmark's camera with the current map view, keeping its name and position in the list. |
| Delete | Remove this bookmark. |
Drag the handle at the left of a bookmark header to reorder it. The handle appears on header hover or keyboard focus. To reorder with the keyboard, focus the handle, press Space, use Up/Down, then press Space again to drop it. Escape cancels the reorder.
Use the floating panel
Bookmarks are off by default, including when opening older configurations. Enable the Bookmarks switch to show saved bookmarks on the map. The panel appears once there is at least one bookmark and stays usable when the sidebar is closed. Click a bookmark row to visit its view. Its overlaid Copy coordinates button appears when that row is hovered or a control in the row has keyboard focus.
Click the floating panel's × to hide it and turn off the Bookmarks switch. Turn the switch on again to reopen it. Closing or disabling the panel does not delete bookmarks; you can still edit them in the sidebar. Collapsing the sidebar section is independent of this switch.
On desktop, drag the title bar labeled Bookmarks to move the panel. Drag either the top or bottom edge handle to resize its height. The minimum height fits the title and one bookmark; additional bookmarks remain available by scrolling. With the keyboard, focus the title bar or a resize handle, press Space, use the arrow keys, and press Space again to finish. The copy and close controls work independently of dragging.
Saved views and supported modes
Saved map configurations retain bookmark names, order, and camera views when loaded in a version that supports Bookmarks. Configurations without bookmarks still load normally. The Bookmarks switch is a UI preference, separate from these saved views; loading views does not turn it on automatically or reset an explicitly enabled UI preference.
Bookmark editing and navigation support a single 2D or 3D Mercator map. In globe or split-map mode, the floating panel is hidden and bookmark editing is unavailable. Return to a single Mercator map to use the saved views again.
Fade on Zoom
Fade on Zoom changes the opacity of selected layers and annotations as you zoom. Each controller applies one fade range to its selected targets.
- Open Interactions → Fade on zoom by clicking its header or settings icon.
- Click + Add controller.
- In Layers and annotations, select one or more targets. A target can belong to only one controller; remove it from its current controller before assigning it to another.
- Adjust the four handles on the controller's graph, then turn on the Fade on zoom switch to apply the effect. Adding or editing a controller does not turn the switch on automatically.
Set the zoom range
The graph runs from zoom 0 to 24. Drag a handle horizontally to change its zoom level. The four handles stay in order; moving one past a neighbor moves that neighbor too.
| Handle | Meaning as you zoom in | Initial value |
|---|---|---|
| Appear | The target is invisible at and below this zoom, then starts fading in. | 1 |
| Full start | The fade-in ends and the target reaches its normal opacity. | 3 |
| Full end | The target starts fading out from its normal opacity. | 8 |
| Disappear | The target is invisible at and above this zoom. | 12 |
Opacity changes linearly between Appear and Full start, stays at the normal value through Full end, then falls to zero at Disappear. For example, with values 2, 4, 8, 10, zoom 3 applies half the normal opacity, zooms 4–8 use the normal opacity, and zoom 9 applies half again. Zooming out follows the same range in reverse.
When the two fade-in handles coincide, the target switches on immediately above Appear, provided Disappear is higher. When the two fade-out handles coincide, it switches off at Disappear. The target remains invisible at the outer boundaries. If Appear and Disappear coincide, all four handles coincide and the target stays invisible at every zoom.
Focus a handle and use the arrow keys to adjust it by 0.1 zoom levels, or hold Shift for steps of 1. The vertical marker shows the current map zoom.
Manage controllers
Use multiple controllers for groups that need different zoom ranges. Remove a target from the selector to stop applying that controller to it, or use the controller's trash icon to delete the controller. Deleting a controller leaves its layers and annotations on the map.
Turning off Fade on zoom keeps the controllers but stops applying their fades. Unassigned targets retain their normal appearance. For layers, the fade multiplies the existing opacity setting; it does not replace it or turn a hidden layer on. Controller targets, ranges, and the enabled state are retained in saved map configurations.