Datasets

You can use the Mapbox Studio dataset editor to import, create, and edit point, line, and polygon features and their properties. A collection of these features in Mapbox is called a dataset. Datasets can either be downloaded as GeoJSON or exported to tilesets for use in Mapbox styles (see the Introduction section for more information).


Mapbox Studio topics covered in this section:

What is a dataset?

A dataset is an editable collection of GeoJSON features. Datasets are distinct from tilesets in that datasets can be edited on a feature-by-feature basis, but cannot be used directly in Mapbox Studio style.

Any dataset you create can be exported to a tileset, which can be then added as a layer in the Mapbox Studio style editor.

Downloading and exporting datasets

Once you’ve created a dataset, you can export it to a tileset for use in a Mapbox map (see Style editor for more information), download it as a GeoJSON FeatureCollection, or use it with the Datasets API. Datasets can also be edited after export. To learn how to download and export datasets, see below.

Manage datasets

Your Datasets page in Mapbox Studio provides a list of your existing datasets as well as a link to create a new dataset.

Search datasets

Use the Search bar to filter or reorder your list of datasets. You can search for datasets by name or dataset ID and sort by name or date modified.

Create a new dataset

To create a new dataset, click the New dataset button at the top of the page. You can either start with a blank dataset or upload data as a starting point for your dataset. Data must be in one of the accepted data formats. Once your dataset is created, it opens in the dataset editor for editing.

Once a dataset is created, it appears in the list on your Datasets page. There are several actions you can take with each dataset.

Export to tileset

Once exported, the tilesets can be added as a new custom layer to a Mapbox map in the Mapbox Studio style editor. You can also add a tileset directly to a web map by using Mapbox GL JS like in this example.

Download as GeoJSON

Once created, you can download your data as a GeoJSON file to use with Mapbox GL JS or other web mapping applications.

Delete

Tileset deletion cannot be undone. Any tilesets that were derived from this dataset will remain intact, but you will no longer be able to update the data associated with those tilesets in the dataset editor.

Dataset ID

Each dataset has a unique ID. Use this ID when interacting with your dataset using the Mapbox Datasets API.

Dataset editor

In addition to managing datasets, Mapbox Studio provides an in-browser editor for creating and modifying dataset features.

Export to tileset

Manage features

Map canvas

Toolbar



Export to tileset

To add your data to a style in the Mapbox Studio style editor, you need to export your dataset to a tileset.

  • Save: After you have finished editing your dataset, click Save to review the changes you have made.

  • Export: Click Export to export your dataset to a vector tileset. A vector tileset is a collection of data broken up into a uniform grid of square tiles at up to 22 preset zoom levels. Your tilesets are stored on the Tilesets page in your Mapbox account, and tilesets created through dataset export have a reference back to the original dataset. See the Uploads section for more information on using tilesets.

If you need to make further changes to your data, you can modify a dataset after you have exported to a tileset and re-export to have those changes reflected in the tileset. If you update a connected tileset, any styles that reference that tileset will also be updated automatically.

Manage features

Features are individual points, lines, or polygons in your dataset. In the dataset editor you can add, modify, and delete features in your dataset.

Add new features

You can add new features to an existing dataset by either importing them from a data file or drawing them directly in the editor.

  • Import You can import data into your dataset from a GeoJSON or CSV file. If using a CSV, make sure that the data is already geocoded and represents point features.
  • Draw tools: Use the draw tools to draw features directly on the map. You can modify the geometry, placement, and properties of existing features with the dataset editor’s draw tools.
    • Draw a point
    • Draw a line
    • Draw a polygon
  • Search places: You can search places in the toolbar. When you search for a country, region, postcode, place, locality, neighborhood, or address you will have the option to Save to dataset. This option is not available when searching POIs.
Edit feature properties

You can add, edit, and delete feature properties using tools in the panel on the left side of the dataset editor. You can also view feature properties in GeoJSON form by clicking the GeoJSON tab.

edit properties dataset editor

Map canvas

You can interact directly with the features in your dataset on the map to draw, modify or delete features.

  1. Geometry: Modify the geometry by clicking on the feature, then clicking and dragging the points.
  2. Placement: Hover over the feature until you see , then click and drag to move the feature.
  3. Properties: To modify the properties of a feature, click on the feature and edit properties in the panel on the left side of the editor.

You can delete a feature by selecting the feature and clicking . You can select and delete multiple features at once using Shift + click + drag.

Toolbar

The toolbar in the upper right will help you navigate the dataset editor.

Search places

The Search places search bar allows you to search for locations on the map. You can find this button on the top right. Type in what you’re looking for and select the result to be taken to that exact location. This search is powered by the Mapbox Geocoding API.

search-places-dataset

Search dataset

You can use Search dataset to search your dataset by a property value. The search will return all features that contain that property value. Click on the thumbnail to jump to the feature on the map.

search-within-dataset

Background style

Use the Background button to switch between background styles. These include the default dataset editor style, Mapbox Satellite, Mapbox Satellite Streets, and an empty canvas.

change-backgrounds-dataset

Reference tileset

In addition to the pre-loaded background layers, you can display a custom raster tilesets (such as your own custom satellite imagery, for example) between the basemap and your data as a reference for drawing new GeoJSON features. Click Reference tileset and select the tileset you would like to add. Note that this must be a raster tileset uploaded to your account. You can remove the raster tileset by clicking Deselect or by clicking on the active tileset.

add-reference-tileset-dataset

History

View your history by clicking the History button. The dataset keeps a history of all changes that have been made since the beginning of your current session. You can revert any changes that have been made during your current session, but your history will reset once you exit the dataset editor.

Help

The Help button includes the option to see a guided walkthrough of the dataset editor. As you scroll through this panel, you will see a list of keyboard shortcuts. At the top of the help panel, there are links to Mapbox Help and our contact page.

Dataset information page

For each dataset, there is a dataset information page where you can review the tilesets that are connected to that dataset and accomplish the same tasks that you can in the menu on the Datasets page.

Connected tilesets

The center of the dataset information page contains a list of all connected tilesets, which can be added to your styles as new custom layers.

The same items that exist in the menu for each dataset on the Datasets page are listed on the right side of the dataset information page. See the menu section for more details.

Dataset characteristics

In the lower right side of the dataset information page, there are several characteristics that are listed for each dataset.

  • Size: Size of the dataset.

  • Feature count: The number of features included in the dataset.

  • Bounds: The coordinate bounds the dataset resides within, which are both listed and displayed on a satellite map.

Edit dataset

Click Edit to open the dataset editor and make changes to the dataset.

Next section:

Publish your style

Learn how to publish map styles made in Mapbox Studio.

Additional questions? Ask our support team or learn more about How Mapbox Works.