mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
0.54.1 is the newest release of 0.42.x.
In short
7 breaking9 new10 fixed
- breaking
Require that
heatmap-coloruse expressions instead of stop functions #5624 - breaking
Remove support for validating and migrating v6 styles
- breaking
Remove support for validating v7 styles #5604
- breaking
Remove support for including
{tokens}in expressions fortext-fieldandicon-image#5599 - breaking
Split
curveexpression intostepandinterpolateexpressions #5542 - breaking
Disallow interpolation in expressions for
line-dasharray#5519 - breaking
Map#getLightno longer returns default values; it only returns values explicitly set in the style or at runtime #5682
Release note
Breaking changes
- breaking
Require that
heatmap-coloruse expressions instead of stop functions #5624 - breaking
Remove support for validating and migrating v6 styles
- breaking
Remove support for validating v7 styles #5604
- breaking
Remove support for including
{tokens}in expressions fortext-fieldandicon-image#5599 - breaking
Split
curveexpression intostepandinterpolateexpressions #5542 - breaking
Disallow interpolation in expressions for
line-dasharray#5519 - breaking
Map#getLightno longer returns default values; it only returns values explicitly set in the style or at runtime #5682
Features and improvements
Improve label collision detection #5150
Labels from different sources will now collide with each other
Collisions caused by rotation and pitch are now smoothly transitioned with a fade
Improved algorithm for fewer erroneous collisions, denser label placement, and greater label stability during rotation
Add
sqrtexpression #5493
Bug fixes and error reporting improvements
Fix viewport calculations for
fitBoundswhen both zooming and padding change #4846Fix WebGL "range out of bounds for buffer" error caused by sorted symbol layers #5620
Fix symbol fading across tile reloads #5491
Change tile rendering order to better match GL Native #5601
Ensure no errors are triggered when calling
queryRenderedFeatureson a heatmap layer #5594Fix bug causing
queryRenderedSymbolsto return results from different sources #5554Account for
circle-stroke-widthinqueryRenderedFeatures#5514Fix rendering of fill layers atop raster layers #5513
Fix rendering of circle layers with a
circle-stroke-opacityof 0 #5496Fix memory leak caused by actor callbacks #5443
Fix source cache size for raster sources with tile sizes other than 512px #4313
Validate that zoom expressions only appear at the top level of an expression #5609
Validate that step and interpolate expressions don't have any duplicate stops #5605
Fix rendering for
icon-text-fitwith a data-driventext-size#5632Improve validation to catch uses of deprecated function syntax #5667
Permit altitude coordinates in
positionfield in GeoJSON #5608