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
9 new18 fixed
Release note
Features and improvements
Improve performance for maps with many textures (such as styles with satellite imagery), fixing excessive memory usage. (h/t @tristan-morris) #12924
Add
raster-elevationproperty for elevating raster layers to a constant height (e.g. clouds over globe).Add
raster-emissive-strengthandfill-extrusion-emissive-strengthproperties for controlling 3D lighting on buildings and raster layers.Add
MapgetConfigPropertymethod for getting current style config values.Add
configsupport in terrain options.Improve performance for pitched views with many fill extrusions on higher zoom levels.
Allow turning off the terrain that is defined in the imports on the root-level Style by setting it to
null.Allow the partial terrain exaggeration update without specifying the source.
Respect style schema restrictions (
minValue,maxValue,stepValue,values,type) when evaluating config options.
Bug fixes
Fix an issue where
center: [0, 0]andzoom: 0map options were ignored in favor of style settings.Fix an issue with the camera not taking the short route when animating between locations across the anti-meridian.
Fix an issue where a style with imports sometimes loaded in incomplete state.
Fix an issue with rendering styles with nested imports.
Fix an issue with sources not reloading when changing language and worldview.
Fix an issue where updating a style fragment URL didn't work correctly.
Fix an issue when adding a layer with explicit
slotnot taking precedence over thebeforeparameter for layer order.Fix an issue where updating an image before initial image is loaded produced an error. (h/t @maciejmatu) #12928
Fix an issue with incorrect collisions for elevated symbols.
Fix an issue with
"camera-projection": "orthographic"not working in styles with imports.Fix an issue with tiles sometimes missing in terrain mode on views from a hill down on a valley.
Fix compact attribution style when using global CSS that sets
box-sizing: border-box. (h/t @simondriesen) #12982Remove redundant
aria-labelattribute in attribution control that fails accessibility conformance. (h/t @maggiewachs) #12981Disable terrain and hillshade when browser fingerprinting protection (e.g. in private browsing mode) prevents it from rendering correctly.
Fix layer rendering when import requests are failing.
Fix map
loadevent not firing for the sources whose tiles are 404s.Require either
urlortilesfor tiled sources during validation.Validate for empty layer and source IDs in runtime.
Changes since v3.1.0-beta.1
Features and improvements
Allow turning off the terrain that is defined in the imports on the root-level Style by setting it to
null.Allow the partial terrain exaggeration update without specifying the source.
Respect style schema restrictions (
minValue,maxValue,stepValue,values,type) when evaluating config options.
Bug fixes
Disable terrain and hillshade when browser fingerprinting protection (e.g. in private browsing mode) prevents it from rendering correctly.
Fix layer rendering when import requests are failing.
Fix map
loadevent not firing for the sources whose tiles are 404s.Require either
urlortilesfor tiled sources during validation.Validate for empty layer and source IDs in runtime.