Packages

mapbox-gl

3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed

Your version

3.32.0

29 Sep 2026Where it was published

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/#prerender now receive a CustomLayerRenderParameters object as an 8th argument, exposing projectionMatrix (camera→clip), viewMatrix (world→camera) pair, plus the globe horizon globeClippingPlane and the globe center's screen position globeCenterInScreenPixels.

Bug fixes

  • Fix raster-array chunk loading when unused.

  • Fix transformRequest headers and credentials being dropped from PMTiles requests.

  • Fix transformRequest headers/credentials being dropped when loading GL model (GLTF) resources.

  • Fix features rendering at the wrong position when a layer uses a within filter 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 padding as a sideeffect in a preloadOnly animation.

  • Respect extra_bounds on 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.