Packages

mapbox-gl

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

Upgrading mapbox-gl From 3.29.0 to 3.34.2

6 releases in betweennotes for 5

  1. 3.29.0yours
  2. 3.30.0breaking
  3. 3.31.0breaking
  4. 3.32.0
  5. 3.33.0breaking
  6. 3.34.1
  7. 3.34.2target
  8. 7 pre
4+
changes to make
0
advisories fixed
29+
new
30+
fixes

Counted from 5 of 6 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

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