Packages

mapbox-gl

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

Upgrading mapbox-gl From 0.19.1 to 0.54.1

49 releases in betweenevery note read

Other targets from 0.19.1Latest3.34.2
  1. 0.19.1yours
  2. 0.20.0major
  3. 1 release
  4. 0.21.0major
  5. 0.22.0major
  6. 1 release
  7. 0.23.0major
  8. 0.24.0major
  9. 0.25.0major
  10. 1 release
  11. 0.26.0major
  12. 0.27.0major
  13. 0.28.0major
  14. 0.29.0major
  15. 0.30.0major
  16. 0.31.0major
  17. 0.32.0major
  18. 1 release
  19. 0.33.0major
  20. 1 release
  21. 0.34.0major
  22. 0.35.0major
  23. 1 release
  24. 0.36.0major
  25. 0.37.0major
  26. 0.38.0major
  27. 0.39.0major
  28. 1 release
  29. 0.40.0major
  30. 1 release
  31. 0.41.0major
  32. 0.42.0major
  33. 2 releases
  34. 0.43.0major
  35. 0.44.0major
  36. 2 releases
  37. 0.45.0major
  38. 0.46.0major
  39. 0.47.0major
  40. 0.48.0major
  41. 0.49.0major
  42. 0.50.0major
  43. 0.51.0major
  44. 0.52.0major
  45. 0.53.0major
  46. 1 release
  47. 0.54.0major
  48. 0.54.1target
47
changes to make
0
advisories fixed
287
new
384
fixes

Before you upgrade

Tick each one off as you go
  • breaking0.54.0
  • breaking0.54.0
  • breaking0.52.0
  • breaking0.49.0
  • breaking0.48.0
  • breaking0.46.0
  • breaking0.45.0
  • breaking0.45.0
  • breaking0.44.2
  • breaking0.44.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)

  7. 0.50.0

    12 Oct 20187 new · 17 fixes
    • new

      🎉 Add Custom Layers that can be rendered into with user-provided WebGL code

    • new

      Add WebGL face culling for increased performance

    • new

      Improve speed of expression evaluation

    • new

      Automatically coerce to string for concat expression and text-field property (#6190, fixed by #7280)

  8. 0.49.0

    Migration needed12 Sep 201811 new · 8 fixes
    • breaking

      Use client{Height/Width} instead of offset{Height/Width} for map canvas sizing (#6848, fixed by #7128)

    • new

      Improve time to first render by updating how feature ID maps are transferred to the main thread (#7110, fixed by #7132)

    • new

      Reduce size of JSON transmitted from worker thread to main thread

    • new

      Improve image/glyph atlas packing algorithm

12 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

  • Upgrade ESM dependency to ^3.0.39

    0.46.0

  • Ditch gl-matrix fork in favor of the original package

    0.46.0

  • Update to latest sinon

    0.46.0

  • Upgrade to Flow 0.69

    0.46.0

  • Update to mapbox-gl-supported 1.4.0

    0.46.0

  • Use flow to type much of the code base #4629 #4903 #4909 #4910 #4911 #4913 #4915 #4918 #4932 #4933 #4948 #4949 #4955 #4966 #4967 #4973 💪 @jfirebaugh @vicapow

    0.39.0

  • Use style specification to generate flow type #4958

    0.39.0

  • Explicitly list which files to publish in package.json #4819 @tomscholz

    0.39.0

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