mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
2.15.0 is the newest release of 2.x.
In short
8 new17 fixed
Release note
Features ✨ and improvements
Add support for
cameraForBoundswith globe projectionAdd support for
fitBoundsandfitScreenCoordinateswith globe projectionImprove support for
getBoundswith globe projection.Improve symbol placement performance with globe projection
Add new marker styling option
occludedOpacityallowing the user to set the opacity of a marker that's behind 3D terrain (h/t jacadzaca)Cancel
ImageSourceimage request when underlying resource is no longer used (#12266) (h/t maciejmatu)Add object literal support in
LngLatBounds.extend(#12270) (h/t stampyzfanz)Add live performance counters. Mapbox-gl-js v2.11.0 collects certain performance and feature usage counters so we can better benchmark the library and invest in its performance. The performance counters have been carefully designed so that user-level metrics and identifiers are not collected.
Bug fixes
Fix elevation of pole geometry when exaggerated terrain is used
Fix
GeolocateControlsometimes not working in iOS16 WebViewFix map crashing on conformal projections at the south pole
Fix pixel flickering between tiles on darker styles in globe view.
Fix occasional missing tiles at bottom of screen during globe-mercator transition
Fix incorrectly requiring three finger drags to change pitch with cooperative gestures while in fullscreen.
Fix jumping when scrolling with mouse when crossing the antimeridian on projections that wrap.
Fix terrain error being fired when using
map.getStyle()with globe viewFix occasional artifacts appearing in the ocean with terrain or globe enabled.
Fix invalid AABB calculation as part of the globe tile cover
Fix incorrect shading of corners in fill extrusions when ambient occlusion is enabled.
Fix potential performance regression on image source updates
Fix memory leak when removing maps (#12224) (h/t joewoodhouse)
Fix updating marker position when toggling between world copied projections and projections without
Fix missing icons in some styles.
Fix overwriting all feature ids while setting promoteIds on other layers with an object. (#12322) (h/t yongjun21)
Fix cursor returning to original state after a popup with
trackPointeris removed (#12230) (h/t camouflagedName)