Packages

mapbox-gl

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

Upgrading mapbox-gl From 3.20.0 to 3.21.0

1 release in betweenevery note read

Other targets from 3.20.0Newest 3.x, Latest3.34.2
  1. 3.20.0yours
  2. 3.21.0target
2
changes to make
0
advisories fixed
6
new
8
fixes

Before you upgrade

Tick each one off as you go
  • breaking3.21.0
  • breaking3.21.0

Release by release

  1. 3.21.0

    Migration needed2 Apr 20266 new · 8 fixes
    • 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.

    • new

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

    • new

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