Skip to main content


KML is a file format that is commonly used in Google products. KML is similar to GeoJSON and can store points, lines, polygons, and other vector data. Unlike GeoJSON, it's based on XML rather than JSON.

You can upload KML files to Mapbox Studio as vector tilesets that you can use in a custom map style.

It is important to note that when you create a KML file, the additional custom attributes go into an <extendedData> element. Mapbox is unable to use the contents of that element to create attributes for the tileset, so if you want to upload a tileset with custom attributes, GeoJSON may be a more appropriate format. You can use a tool like togeojson, or QGIS to convert your file from a KML to a GeoJSON.

Related resources:

arrow-downDownload sample KML
Was this page helpful?