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
7 new14 fixed
Release note
Features and improvements
Add
scaleFactorsupport for images withintext-field.Add
showButtonoption toGeolocateControlthat allows hiding the control button.Add
followUserLocationoption andsetFollowUserLocationmethod toGeolocateControlto control whether the map follows the user's location.Improve
GeolocateControltimeout handling.Add support for
text-rotate,text-size, andtext-offsetproperties in appearances.Add
shadow-draw-before-layerproperty to directional light, allowing control over shadow draw order in the layer stack.Add
model-allow-density-reductionproperty to model layers. (h/t @JoshuaJMoore)
Bug fixes
Fix interaction handlers not working on model layers.
Fix stretchable icons without
icon-text-fitrendering with an incorrect size.Fix
icon-sizenot working correctly withcoalesceexpressions.Fix
raster-colorinterpolation when usingnearestraster-resampling.Fix render cut off for elevated raster-layer rendering in ortho projection range.
Fix symbol placement with optional and missing parts.
Expose all error properties for
GeolocateControlerror event (h/t @lucavb).Fix an error when querying multipolygons in
dynamic: truemode.Fix
AttributionControllinks sanitization.Fix appearances with no
icon-sizeusing the default value instead of the layout-defined one.Fix updates to model source via
ModelSource.setModelswhile models are still loading.Fix polygon clipping precision errors causing rendering artifacts in elevated structures.
Preserve featuresets in
map.getStyle()output.Expose TypeScript types from
@mapbox/mapbox-gl-style-specfor direct imports.