mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
0.54.1 is the newest release of 0.54.x.
In short
2 breaking14 new10 fixed
- breaking
Turned
localIdeographFontFamilymap 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). AddlocalIdeographFontFamily: falseto turn this off. #8008 - breaking
Added
PopupmaxWidthoption, set to"240px"by default. #7906
Release note
Breaking changes
- breaking
Turned
localIdeographFontFamilymap 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). AddlocalIdeographFontFamily: falseto turn this off. #8008 - breaking
Added
PopupmaxWidthoption, set to"240px"by default. #7906
Major features
Added support for updating and animating style images. #7999
Added support for generating style images dynamically (e.g. for drawing icons based on feature properties). #7987
Added antialiasing support for custom layers. #7821
Added a new
mapbox-gl-csp.jsbundle for strict CSP environments whereworker-src: blobis disallowed. #8044
Minor features and improvements
Improved performance of fill extrusions. #7821
Improved performance of symbol layers. #7967
Slightly improved rendering performance in general. #7969
Slightly improved performance of HTML markers. #8018
Improved diffing of styles with
"visibility": "visible". #8005Improved behavior of
canvasSource.pauseto be more reliable and able to render a single frame. #8130Improved zoom buttons to grey out when reaching min/max zoom. #8023
Added a title to fullscreen control button. #8012
Added
rel="noopener"attributes to links that lead to external websites (such as Mapbox logo and OpenStreetMap edit link) for improved security. #7914Added tile size info when
map.showTileBoundariesis turned on. #7963Significantly improved load times of the benchmark suite. #8066
Bug fixes
Fixed a bug in Mac Safari 12+ where controls would disappear until you interact with the map. #8193
Fixed a bug where rapid zooming could produce an
Uncaught TypeError: e is not a functionerror in the console. #7988Fixed a bug where
removeFeatureStatedidn't remove the state for tiles on other zoom levels. #8087Fixed a bug where
removeFeatureStatedidn't work on features withidequal to0. #8150Fixed a memory leak when calling
source.setData(url)many times. #8035Fixed a bug where marker lost focus when dragging. #7799
Fixed a bug where
map.getCenter()returned a reference to an internalLngLatobject instead of cloning it, leading to potential mutability bugs. #7922Fixed a bug where default HTML marker positioning was slightly off. #8074
Fixed a bug where adding a fill extrusion layer for non-polygon layers would lead to visual artifacts. #7685
Fixed intermittent Flow failures on CI. #8061