Tilesets

Tilesets are the primary data format for Mapbox maps. Whether you start with your own custom data or you create a dataset first, converting your data into a tileset will allow you to add it to a Mapbox map and style it using the Mapbox Studio style editor.


Mapbox Studio topics covered in this section:

What is a tileset?

A tileset is a collection of raster or vector data broken up into a uniform grid of square tiles at up to 22 preset zoom levels. Tilesets are used in Mapbox libraries and SDKs as a core piece of making maps visible on mobile or in the browser; they are also the main mechanism we use for determining map views.

Tilesets are highly cacheable and load quickly. Mapbox relies heavily on both raster and vector tilesets to keep our maps fast and efficient.

Manage tilesets

The Tilesets page is where you can add and manage your uploaded tilesets.

tilesets

The Tilesets page shows you a list of all of your uploaded tilesets, plus the three Mapbox-provided tilesets: Mapbox Streets, Mapbox Satellite, and Mapbox Terrain.

Unlike the tilesets you upload, the Mapbox Streets and Mapbox Terrain tilesets have layers that group certain features together. Any tilesets you upload will appear below the tilesets Mapbox provides.

New tileset

Click the New tileset button to create a new tileset. You can either Upload a file or Create from dataset.

Note: When a vector data file is uploaded to Mapbox, it is converted to vector tile format. When a raster data file (like an image) is uploaded to Mapbox, it becomes a set of tiled PNGs.

Upload a file

When uploading a file, the uploads pane will appear in the lower left corner of the page. This pane shows the map ID and status of your upload — the circle will be blue while the file is processing and green once the file has been uploaded.

For more information about uploading data to your Mapbox account, see the Uploads page.

Create from dataset

Click the Create from dataset tab to create a tileset from a dataset. A modal will appear with a list of all datasets associated with your account. Choose a dataset from the list and click Export dataset. You will have the choice to either Export to a new tileset or, if that dataset is already connected to a tileset, the option to Update a connected tileset.

Tileset menu

For each tileset, you can either click on the name of the tileset to go to its information page or click the button for more options:

Add to style

Add the tileset to an Existing style or a New style.

Replace

Replace the current data in your tileset with new data. The map ID will remain the same and the new data will be reflected in all styles that reference this tileset.

Make private

You can restrict the tilesets you upload to your Mapbox account so they can only be loaded with one of your access tokens. This means that other users cannot use their access tokens to access your tilesets. Your tilesets will continue to be accessible only using access tokens from your Mapbox account. This feature is currently only available to Premium and Enterprise customers.

Delete

You can permanently delete a tileset from your account at any time. Deleted tilesets may not be recovered.

Map ID

From this menu, you can also copy the Map ID to be used with Mapbox SDKs and APIs.

Tileset information page

data info

Each tileset has an information page that provides additional information about the tileset. It includes three tabs:

  • Vector layers: groupings of data within the tileset. Your custom tilesets will only have one layer; Mapbox Streets and Mapbox Terrain include multiple layers. Each layer in the listing has information on geometry type, zoom levels of the data, and data attributes and value types.
  • Used in styles: lists the styles in which the tileset is used.
  • Stats: shows analytics for the tileset, including map views, tile views, static views, and surface requests.

From this page you can also replace the data in the tileset, make the tileset private, and delete the tileset.

The right sidebar of the page includes additional information about the tileset, including:

  • the map ID of the tileset
  • the format of the tileset
  • the type of the tileset (raster or vector)
  • the size of the tileset
  • the zoom extent of the tileset, or which zoom levels have been rendered — vector tilesets can be styled up to zoom level 22, but data will be simplified to the highest rendered zoom level
  • a map showing the bounds of the tileset
Next section:

Datasets

Learn how to create and manage datasets in Mapbox Studio.

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