Packages

mapbox-gl

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

Upgrading mapbox-gl From 0.17.0 to 3.34.2

162 releases in betweennotes for 160

Other targets from 0.17.0Newest 0.x0.54.1
  1. 0.17.0yours
  2. 0.18.0major
  3. 0.19.0major
  4. 1 release
  5. 0.20.0major
  6. 1 release
  7. 0.21.0major
  8. 0.22.0major
  9. 1 release
  10. 0.23.0major
  11. 0.24.0major
  12. 0.25.0major
  13. 1 release
  14. 0.26.0major
  15. 0.27.0major
  16. 0.28.0major
  17. 0.29.0major
  18. 0.30.0major
  19. 0.31.0major
  20. 0.32.0major
  21. 1 release
  22. 0.33.0major
  23. 1 release
  24. 0.34.0major
  25. 0.35.0major
  26. 1 release
  27. 0.36.0major
  28. 0.37.0major
  29. 0.38.0major
  30. 0.39.0major
  31. 1 release
  32. 0.40.0major
  33. 1 release
  34. 0.41.0major
  35. 0.42.0major
  36. 2 releases
  37. 0.43.0major
  38. 0.44.0major
  39. 2 releases
  40. 0.45.0major
  41. 0.46.0major
  42. 0.47.0major
  43. 0.48.0major
  44. 0.49.0major
  45. 0.50.0major
  46. 0.51.0major
  47. 0.52.0major
  48. 0.53.0major
  49. 1 release
  50. 0.54.0major
  51. 1 release
  52. 1.0.0major
  53. 18 releases
  54. 1.10.0security
  55. 8 releases
  56. 1.13.3security
  57. 2.0.0major
  58. 29 releases
  59. 3.0.0major
  60. 29 releases
  61. 3.19.0security
  62. 8 releases
  63. 3.25.0security
  64. 10 releases
  65. 3.34.2target
  66. 8 pre
76+
changes to make
0
advisories fixed
779+
new
1006+
fixes

Counted from 160 of 162 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.

19 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

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