Packages

mapbox-gl

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

Upgrading mapbox-gl From 2.15.0 to 3.0.0

1 release in betweenevery note read

Other targets from 2.15.0Latest3.34.2
  1. 2.15.0yours
  2. 3.0.0target
2
changes to make
0
advisories fixed
29
new
19
fixes

Start here

Before you upgrade

Tick each one off as you go
  • breaking3.0.0
  • breaking3.0.0

Release by release

  1. 3.0.0

    Migration needed29 Nov 202329 new · 19 fixes
    • breaking

      Discontinue WebGL 1 support. WebGL 2 is now mandatory for GL JS v3 usage, aligned with universal browser support.

    • breaking

      Remove the optimizeForTerrain map option (layer rendering on globe and terrain is always optimized now).

    • new

      Introduced a new 3D Lights API that supports directional and ambient light sources to give you control of lighting and shadows in your map when using 3D objects.

    • new

      Add new *-emissive-strength properties for styling layers with the new lighting API.