LogoLogo
  • Welcome
  • What's new?
  • Docs
    • User guides
      • Get Started
      • Kepler.gl workflow
        • Add data to layers
          • Adding Data Layers
          • Create a Layer
          • Blend and Rearrange Layers
          • Hide, Edit and Delete Layers
        • Add Data to the Map
      • Layers
        • Point
        • S2 Layer
        • Icon
        • Line
        • Cluster
        • Polygon
        • Hexbin
        • Grid
        • H3
        • Heatmap
        • Arc
        • Trip layer
      • Layer Attributes
      • Color Palettes
      • Filters
      • Map Styles
      • Interactions
      • Map Settings
      • Time Playback
      • Save and Export
      • FAQ
    • API Reference
      • ecosystem
      • Get Started
      • Advanced usages
        • Saving and Loading Maps with Schema Manager
        • Replace UI Component with Component Dependency Injection
        • Forward Dispatch Actions
        • Reducer Plugin
        • Using Updaters
        • Custom reducer initial state
        • custom-mapbox-host
      • Components
      • Reducers
        • reducers
        • map-style
        • map-state
        • combine
        • overview
        • ui-state
        • vis-state
      • Processors
        • All processors
      • Schemas
      • Actions
        • All actions
      • Cloud providers
        • Provider
      • Custom theme
      • Localization
    • Jupyter Notebook
  • Examples
    • Node/Express
    • Demo App
    • Open modal
    • Open modal
    • UMD client
    • Customize kepler.gl Theme
    • Customize kepler.gl Reducer
  • Contributing
    • Developing Kepler.gl
    • Contributor Covenant Code of Conduct
  • Change Log
  • Upgrade Guide
Powered by GitBook
On this page
  • Export Image
  • Export Data
  • Export Map
  • Export Map as HTML
  • Export Map as JSON
  • Share Public URL (Dropbox)

Was this helpful?

  1. Docs
  2. User guides

Save and Export

PreviousTime PlaybackNextFAQ

Last updated 1 year ago

Was this helpful?

Save and Export

kepler.gl is a client-side only application. In the demo app, the data you uploaded stays in your browser. kepler.gl does not send or store any user data to any backends. This rule poses an limitation on how you can save and share your maps.

However, in the demo app, you can:

  • .

  • .

You can export the current map as an image. The export window will use the current map viewport, and the preview will show the entire exported map area. To adjust the viewport, you will have to close the export dialog. You can choose different export ratios or resolutions, and also to add a map legend.

You can export map data as a csv file, with the option to export ONLY the filtered data or the entire dataset.

You can export the current map using two different formats. The Export Map window provides two options:

  • HTML: create a single html file loads and renders your current map.

  • JSON: create a json file with your current map config and data.

To save and export your current map as HTML file, click on Export Map and subsequently on Export. When prompted provide your own mapbox token to be used in the newly generated file. If you don't provide a Mapbox Token, Kepler.gl will use a default one which can expire at anytime without any communication and therefore break your your existing map.

How to update an exported map token

In order to edit the mapbox token in your html file you simply need to perform the following steps:

  1. Open the kepler.gl.map file with your favorite text editor.

  2. Locate the following line in the exported file kepler.gl.html:

  /**
   * Provide your MapBox Token
   **/
  const MAPBOX_TOKEN = 'CURRENT_TOKEN';
  1. Replace the current value a new valid token. The code should now look like the following:

  /**
   * Provide your MapBox Token
   **/
  const MAPBOX_TOKEN = 'pk.eyJ1IjoidWJlcmRh...';

You can export the current map as a json file. This is useful when you are running your own kepler.gl application and want to load your map programmatticaly. The JSON file includes:

  • dataset: processed data to create used to render your map

  • config: layer, filter, map style and interaction settings. The map config includes the current layer, filter, map style and interaction settings.

Note: kepler.gl map config is coupled with loaded datasets. The dataId key is used to bind layers, filters and tooltip settings to a specific dataset. If you try to upload a configuration with a dataset in your own kepler.gl app, you also need to make sure your dataset id matches the dataId in the config.

To export the current map into your Dropbox account, click on Share Public Url and select Dropbox as your cloud storage. Perform the authentication against Dropbox using your credentials. Once the authentication process is completed, click on Upload and Kepler.gl will push your current map onto your account.

At the end of the process Kepler.gl will automatically generate a permalink for your work you can share with other users.

Export Image

Export Data

Export Map as HTML

or use your existing one.

Export Map as JSON

Export Map to Dropbox

Create a new mapbox token
Back to table of contents
Export Image
Export Data
Export Map
Export Map as HTML
Export Map as JSON
Share Public URL (Dropbox)
Export map as an image
Export filtered or unfiltered data as a csv
Export Map
Share Public URL (Dropbox)