Packages

mapbox-gl

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

Upgrading mapbox-gl From 0.39.0 to 3.34.2

133 releases in betweennotes for 131

Other targets from 0.39.0Newest 0.x0.54.1
  1. 0.39.0yours
  2. 1 release
  3. 0.40.0major
  4. 1 release
  5. 0.41.0major
  6. 0.42.0major
  7. 2 releases
  8. 0.43.0major
  9. 0.44.0major
  10. 2 releases
  11. 0.45.0major
  12. 0.46.0major
  13. 0.47.0major
  14. 0.48.0major
  15. 0.49.0major
  16. 0.50.0major
  17. 0.51.0major
  18. 0.52.0major
  19. 0.53.0major
  20. 1 release
  21. 0.54.0major
  22. 1 release
  23. 1.0.0major
  24. 18 releases
  25. 1.10.0security
  26. 8 releases
  27. 1.13.3security
  28. 2.0.0major
  29. 29 releases
  30. 3.0.0major
  31. 29 releases
  32. 3.19.0security
  33. 8 releases
  34. 3.25.0security
  35. 10 releases
  36. 3.34.2target
  37. 8 pre
54+
changes to make
0
advisories fixed
634+
new
830+
fixes

Counted from 131 of 133 release notes. Advisories are counted from the advisory database, in full.

Start here

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

  • Upgrade minimist to ^1.2.7 to avoid CVE-2021-44906 (#12442) (h/t @Spasfonx)

    1.13.3

  • Upgrade minimist to ^1.2.5 to get fix for security issue CVE-2020-7598 upstream (#9425, fixed by #9425) (h/t watson)

    1.10.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.

14 other lines we could not sort, mostly version bumps

  • When using queryRenderedFeatures and querySourceFeatures with featureset, fix filter option to apply to featureset selectors rather than original properties, and add featureNamespace validation.

    3.9.1

  • Upgrade Flow from v0.108.0 to v0.142.0 and enable type-first mode, greatly improving performance of type-checking.

    2.8.0

  • Run render tests in browser.

    2.0.0

  • Renamed the default development branch from master to main.

    1.12.0

  • It's now possible to interact with multiple maps on the same page at the same time

    1.10.0

  • A camera change can no longer be prevented by disabling the interaction handler within the camera change event. Selectively prevent camera changes by listening to the mousedown or touchstart map event and calling .preventDefault()

    1.10.0

  • Undocumented properties on the camera change events fired by the doubleClickZoom handler have been removed

    1.10.0

  • Disallow expressions as stop values

    0.51.0

  • Disallow feature-state expressions in filters

    0.51.0

  • Upgrade ESM dependency to ^3.0.39

    0.46.0

6 internal lines (docs, tests, tooling) left out.