Packages

mapbox-gl

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

Upgrading mapbox-gl From 3.9.1 to 3.34.2

35 releases in betweennotes for 34

  1. 3.9.1yours
  2. 14 releases
  3. 3.19.0security
  4. 8 releases
  5. 3.25.0security
  6. 10 releases
  7. 3.34.2target
  8. 8 pre
18+
changes to make
0
advisories fixed
166+
new
214+
fixes

Counted from 34 of 35 release notes. Advisories are counted from the advisory database, in full.

Before you upgrade

Tick each one off as you go
  • breaking3.33.0
  • breaking3.33.0
  • breaking3.31.0
  • breaking3.30.0
  • breaking3.29.0
  • breaking3.28.0
  • breaking3.28.0
  • breaking3.26.0
  • breaking3.25.0
  • breaking3.21.0

Security

  • Fix minor vulnerabilities related to Object prototype pollution from an untrusted style or tiles.

    3.25.0
  • Fix prototype pollution via Style JSON.

    3.19.0

Release by release

  1. 3.34.2no release note

  2. 3.34.1

    29 Oct 20265 new · 8 fixes
    • new

      Improve performance on map views with CJK glyphs by moving CJK rasterization offscreen.

    • new

      Improve tile load performance via optimization of style property values recalculation.

    • new

      Improve rendering performance via per-frame main thread work optimizations.

    • new

      Add support of *-ignore-placement and *-allow-overlap in global placement.

  3. 3.33.0

    Migration needed13 Oct 20266 new · 7 fixes
    • breaking

      Right-to-left text (such as Arabic and Hebrew) is now supported out of the box, loading a small WebAssembly module the first time it appears on the map. setRTLTextPlugin, getRTLTextPluginStatus and the PluginStatus type are removed.

    • breaking

      The base size of icons in the text-field property is now calculated at the tile zoom level with the largest text size. As a result, the icons can be smaller when the text size depends on the zoom level.

    • new

      Improve memory use & map load time, especially for 3D layers.

    • new

      Improve line rendering performance by using a uniform instead of a shader permutation for line-dasharray.

  4. 3.32.0

    29 Sep 20268 new · 9 fixes
    • new

      Slightly improve map load time via more aggressive chunk preloading.

    • new

      Improve style parsing performance.

    • new

      Preload Meshopt decoder earlier to improve 3D styles load time.

    • new

      Improve map load time by requesting the icon set earlier and lazy parsing icons on-demand.

  5. 3.31.0

    Migration needed17 Sep 20263 new · 1 fix
    • breaking

      Remove the experimental flag from raster-allow-draping.

    • new

      Significantly improve GeoJSON memory footprint.

    • new

      Reduce landmark model memory usage.

    • new

      Add support for emissive MRT in custom layers.

    • fixed

      Fix removeSource throwing under globe projection. (h/t @mhayk)

  6. 3.30.0

    Migration needed3 Sep 20267 new · 5 fixes
    • breaking

      Make pitch and rotation states independent. Previously, disabling rotation also disabled pitch. Now, pitch can be enabled independently of rotation.

    • new

      Extract the terrain from the core ESM module.

    • new

      Reduce shader size by removing unused code paths.

    • new

      Upgrade Supercluster to v9 (optimize clustering memory footprint).

  7. 3.29.0

    Migration needed20 Aug 202610 new · 3 fixes
    • breaking

      Remove legacy undocumented Map addSourceType API which was superceded by CustomSourceInterface and experimental TileProvider API.

    • new

      Add new raster-color-scale property, which can be set to "log" to improve color ramp precision when visualizing long-tailed raster datasets.

    • new

      Add new raster-allow-draping property that can be set to false to disable raster layer draping over globe/terrain.

    • new

      Move symbol-z-offset property out of experimental.

  8. 3.28.1

    7 Aug 20261 fix
    • fixed

      Fix iconsets icons rendering with ESM bundle.

1 internal line (docs, tests, tooling) left out.