mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
0.54.1 is the newest release of 0.46.x.
In short
1 breaking18 new17 fixed5 changed1 internal
- breaking
Align implicit type casting behavior of
matchexpressions with withcase/==
Release note
Breaking changes
- breaking
Align implicit type casting behavior of
matchexpressions with withcase/==
Features and improvements
:tada: Add
Map#setFeatureStateandfeature-stateexpression to support interactive stylingCreate draggable
MarkerwithsetDraggableAdd
Map#listImagesfor listing all currently active sprites/imagesAdd "crossSourceCollisions" option to disable cross-source collision detection
Handle
text/icon-rotatefor symbols withsymbol-placement: pointAutomatically compact Mapbox wordmark on narrow maps. (#4282) (h/t andrewharvey)
Only show compacted AttributionControl on interactive displays (#6506) (h/t andrewharvey)
Use postcss to inline svg files into css, reduce size of mapbox-gl.css (#6513) (h/t andrewharvey)
Add support for GeoJSON attribution (#6364) (h/t andrewharvey)
Add instructions for running individual unit and render tests
Make Map constructor fail if WebGL init fails. (#6744) (h/t uforic)
Add browser fallback code for
collectResourceTiming: truein web workersRemove ignored usage of gl.lineWidth
Split new bounds calculation out of fitBounds into new method
Make "Missing Mapbox GL JS CSS" a console warning
Add rel="noopener" to Mapbox attribution link. (#6729) (h/t gorbypark)
Update to deep equality check in example code (#6599) (h/t jonsadka)
Upgrades!
Upgrade ESM dependency to ^3.0.39
Ditch gl-matrix fork in favor of the original package
Update to latest sinon
Upgrade to Flow 0.69
Update to mapbox-gl-supported 1.4.0
Bug fixes
collectResourceTiming: truegenerates error on iOS9 Safari, IE 11Fix PopupOptions flow type declarations (#6670) (h/t TimPetricola)
Add className option to Popup constructor (#6502) (h/t Ashot-KR)
GeoJSON MultiLineStrings with
lineMetrics=trueonly rendered first lineProvide target property for mouseenter/over/leave/out events
Don't break on sources whose name contains "."
Rotate and pitch with navigationControl broke in v0.45
Zero-width lines remained visible
Heatmaps inappropriately clipped at tile boundaries
Use named exports for style-spec entrypoint module (#6601
Don't fire click event if default is prevented on mousedown for a drag event (#6697, fixes #6642)
Double clicking to zoom in breaks map dragging/panning in Edge (#6740) (h/t GUI)
*-transition properties cannot be set with setPaintProperty()
Marker with
aelement does not open the url when clickedsetRTLTextPluginfails with relative URLsCollision detection incorrect for symbol layers that share the same layout properties
Fix a possible crash when calling queryRenderedFeatures after querySourceFeatures
Fix a collision detection issue that could cause labels to temporarily be placed too densely during rapid panning