mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
3.34.2 is the newest release of 3.x.
In short
8 new9 fixed
Release note
Features and improvements
Slightly improve map load time via more aggressive chunk preloading.
Improve style parsing performance.
Preload Meshopt decoder earlier to improve 3D styles load time.
Improve map load time by requesting the icon set earlier and lazy parsing icons on-demand.
Add support for the globe to mercator transition when using the global placement.
Add support for symbol fading when using the global placement.
Add debug visualization support when using the global placement.
CustomLayerInterface#render/#prerendernow receive aCustomLayerRenderParametersobject as an 8th argument, exposingprojectionMatrix(camera→clip),viewMatrix(world→camera) pair, plus the globe horizonglobeClippingPlaneand the globe center's screen positionglobeCenterInScreenPixels.
Bug fixes
Fix
raster-arraychunk loading when unused.Fix
transformRequestheaders and credentials being dropped from PMTiles requests.Fix
transformRequestheaders/credentials being dropped when loading GL model (GLTF) resources.Fix features rendering at the wrong position when a layer uses a
withinfilter and the map uses a projection other than Mercator or globe.Fix global placement throwing an error when placing symbols with no text.
Fix setting
paddingas a sideeffect in apreloadOnlyanimation.Respect
extra_boundson all TileJSON source types.Fix a regression with
map.remove()where it could retain the map instance in memory.Fix light/fog/snow/rain transitions.