Packages

mapbox-gl

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

Upgrading mapbox-gl From 0.53.1 to 3.34.2

112 releases in betweennotes for 110

Other targets from 0.53.1Newest 0.x0.54.1
  1. 0.53.1yours
  2. 0.54.0major
  3. 1 release
  4. 1.0.0major
  5. 18 releases
  6. 1.10.0security
  7. 8 releases
  8. 1.13.3security
  9. 2.0.0major
  10. 29 releases
  11. 3.0.0major
  12. 29 releases
  13. 3.19.0security
  14. 8 releases
  15. 3.25.0security
  16. 10 releases
  17. 3.34.2target
  18. 8 pre
31+
changes to make
0
advisories fixed
496+
new
619+
fixes

Counted from 110 of 112 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.

7 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

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