Packages

mapbox-gl

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

Your version

3.21.0

2 Apr 2026Where it was published

3.34.2 is the newest release of 3.x.

In short

2 breaking6 new8 fixed

  • breaking

    Removed mapbox-gl-unminified.js bundle in the distribution — please switch to either mapbox-gl.js, mapbox-gl-dev.js, or the new esm-min/mapbox-gl.js ESM bundle.

  • breaking

    Removed spriteFormat Map option — now Mapbox styles will always use vector icons, while non-Mapbox styles will continue using classic raster sprites.

Release note

Features and improvements

  • Introduce the TileProvider API, a mechanism for extending GL JS with custom vector tile providers.

  • Add first-class support for PMTiles via the new TileProvider API and an official plugin (mapbox-gl-pmtiles-provider.js) that loads on demand.

  • Add experimental line-blend-mode property for rendering lines using additive or multiply blending.

  • Slightly improve overall map loading times.

  • Improve symbol layer rendering performance (by adopting Uniform Buffer Objects for data-driven properties).

  • Improve indoor maps loading performance.

Bug fixes

  • Fix dragging gesture not working on the compass control.

  • Various fixes and improvements for the Appearances API.

  • Fix an edge case when combining custom icons with images included in the style's sprite.

  • Fix setWorldview not updating layout properties correctly.

  • Fix an issue when rendering stacked underground 3D roads.

  • Fix line dashes with non-integer total array lengths.

  • Fix various rendering issues when using *-cutoff-fade-range properties.

  • Fix clip layer not clipping fill-extrusion ambient occlusion.

Breaking changes

  • breaking

    Removed mapbox-gl-unminified.js bundle in the distribution — please switch to either mapbox-gl.js, mapbox-gl-dev.js, or the new esm-min/mapbox-gl.js ESM bundle.

  • breaking

    Removed spriteFormat Map option — now Mapbox styles will always use vector icons, while non-Mapbox styles will continue using classic raster sprites.