mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
1.13.3 is the newest release of 1.x.
In short
9 new8 fixed
Release note
Features
Add
promoteIdoption to use a feature property as ID for feature stateAdd a new constructor option to
mapboxgl.Popup,closeOnMove, that closes the popup when the map's position changesAllow creating a map without a style (an empty one will be created automatically) ( h/t @stepankuzmin )
map.once()now allows specifying a layer id as a third parameter making it consistent withmap.on()
Improvements
Improve performance of raster layers on large screens
Improve performance for hillshade and raster layers by implementing a progressive enhancement that utilizes
ImageBitmapandOffscreenCanvasImprove performance for raster tile rendering by using the stencil buffer
Update
symbol-avoid-edgesdocumentation to acknowledge the existence of global collision detectionRemove reference to
infunction which has been replaced by theinexpression
Bug Fixes
Change the type of tile id key to string to prevent hash collisions
Prevent changing bearing via URL hash when rotation is disabled
Fix URL hash with no bearing causing map to fail to load
Fix bug in
GeolocateControlwhere multiple instances of the control on one page may result in the user location not being updatedFix query
fill-extrusionsmade from polygons with coincident points and polygons with less than four pointsFix bug where
symbol-sort-keywas not used for collisions that crossed tile boundariesFix bug in
DragRotateHandler._onMouseUpgetting stuck in drag/rotateFix "Click on Compass" on some mobile devices (add
clickTolerancetoDragRotateHandler) (#9015) (h/t Yanonix)