mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
3.34.2 is the newest release of 3.x.
In short
15 new10 fixed
Release note
Features and improvements
Add
background-pitch-alignmentproperty of thebackgroundlayer, which is set tomapby default but can now be set toviewport. Useful for highlighting individual features by dimming the rest of the map with a semitransparent background.Add new control positions (
top,right,bottom, andleft) (h/t @Ethan-Guttman).Add
retainPaddingoption for camera movement methods, which can be set tofalsefor pre-v3.4 padding behavior.Add
configexpression support in layer filter.Add symbol elevation properties:
symbol-z-offsetandsymbol-elevation-reference.Add the
fill-z-offsetproperty for fill layers.Improve
Map#fitBoundsfor the alternative projections.Improve terrain hillshade lighting anchored to viewport.
Improve shadow casting from 3D models.
Improve error messages for invalid expressions.
Skip landmarks rendering when the camera is inside them.
Improve type checking for the
Map#setPaintPropertyandMap#setLayoutPropertymethods.Allow the
stringevent type in Map event handlers.Expose
RequestTransformFunction,ResourceType, andRequestParameterstypes.Improve texture memory footprint on some platforms.
Bug fixes
Fix feature filtering when using 3D lights.
Fix pattern rendering issues on some devices at high zoom levels.
Fix
fill-extrusion-line-widthrendering for large polygonsFix symbol placement ordering when
symbol-z-orderis set toauto.Fix the issue where
minzoomandmaxzoomproperties were ignored bycliplayers.Fix handling previously hidden models in
cliplayers.Fix directional light
cast-shadowsproperty type.Fix an edge case that could produce
setStencilMode-related error in the console with the dev build.Fix an issue where some fill extrusions could temporarily disappear when zooming quickly in certain areas.
Fix an edge case that could cause flickering on a far plane on high zooms.