Packages

mapbox-gl

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

Upgrading mapbox-gl From 0.50.0 to 0.54.1

6 releases in betweenevery note read

Other targets from 0.50.0Latest3.34.2
  1. 0.50.0yours
  2. 0.51.0major
  3. 0.52.0major
  4. 0.53.0major
  5. 0.53.1
  6. 0.54.0major
  7. 0.54.1target

Before you upgrade

Tick each one off as you go
  • breaking0.54.0
  • breaking0.54.0
  • breaking0.52.0

Release by release

  1. 0.54.1

    19 Jul 20191 fix
    • fixed

      Fix unbounded memory growth caused by failure to cancel requests in IE

  2. 0.54.0

    Migration needed25 Apr 201914 new · 10 fixes
    • breaking

      Turned localIdeographFontFamily map option on by default. This may change how CJK labels are rendered, but dramatically improves performance of CJK maps (because the browser no longer needs to download heavy amounts of font data from the server). Add localIdeographFontFamily: false to turn this off. #8008

    • breaking

      Added Popup maxWidth option, set to "240px" by default. #7906

    • new

      Added support for updating and animating style images. #7999

    • new

      Added support for generating style images dynamically (e.g. for drawing icons based on feature properties). #7987

  3. 0.53.1

    27 Feb 20193 fixes
    • fixed

      Turn off telemetry for Mapbox Atlas

    • fixed

      Fix order of 3D features in query results (fix #7883)

    • fixed

      Fix RemovePaintState benchmarks

  4. 0.53.0

    7 Feb 20197 new · 12 fixes
    • new

      Enable fill-extrusion querying with ray picking

    • new

      Add clusterProperties option for aggregated cluster properties (#2412, fixed by #7584)

    • new

      Allow initial map bounds to be adjusted with fitBounds options. (#7681) (h/t elyobo)

    • new

      Remove popups on Map#remove (#7749) (h/t andycalder)

  5. 0.52.0

    Migration needed19 Dec 20184 new · 15 fixes
    • breaking

      Canonicalize tile urls to mapbox:// urls so they can be transformed with config.API_URL

    • new

      Add getter and setter for config.API_URL

    • new

      Allow user to define element other than map container for full screen control

    • new

      Add validation option to style setters

  6. 0.51.0

    7 Nov 20189 new · 9 fixes
    • new

      Add initial bounds as map constructor option (#5518) (h/t stepankuzmin)

    • new

      Improve performance on machines with > 8 cores (#7407, fixed by #7430)

    • new

      Add MercatorCoordinate type

    • new

      Allow browser-native contextmenu to be enabled (#2301, fixed by #7369)

2 other lines we could not sort, mostly version bumps
  • Disallow expressions as stop values

    0.51.0
  • Disallow feature-state expressions in filters

    0.51.0