Skip to main content

tileset ID

Tileset ID or map ID?

Tileset IDs were formerly known as map IDs, following a convention originating from past versions of Mapbox where map styles and map tiles were a unified concept (e.g., in a Mapbox Studio Classic style). In more recent versions of Mapbox, this ID instead refers to the ID of a specific tileset.

A tileset ID is a unique identifier given to every tileset that is uploaded to Mapbox.

A tileset ID always starts with your Mapbox username, followed by the tileset's unique alphanumeric identifier: username.identifier. To find the tileset ID for a specific tileset, go to your Tilesets page. Click the options menu (the options icon) to the right of a tileset's name to find its tileset ID. Tileset IDs cannot be changed once a tileset is created.

Styles made in the Mapbox Studio style editor and datasets uploaded to Mapbox Studio or created through the Mapbox Studio dataset editor do not have tileset IDs. Rather, they are identified with style URLs and dataset IDs.

Use a tileset ID to request tilesets directly

You can request tilesets directly using the tileset ID in a request to the Mapbox Vector Tiles API (for vector tiles) or the Raster Tiles API (for raster tiles). In this example, the tileset ID mapbox.mapbox-streets-v8 is used in a Vector Tiles API request:

https://api.mapbox.com/v4/mapbox.mapbox-streets-v8/1/0/0.mvt?access_token=YOUR_MAPBOX_ACCESS_TOKEN

Related resources:

Was this page helpful?