mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
0.54.1 is the newest release of 0.27.x.
In short
5 breaking7 new13 fixed4 internal
- breaking
Replace
fill-extrude-heightandfill-extrude-baseproperties offillrender type with a separatefill-extrusiontype (with correspondingfill-extrusion-heightandfill-extrusion-baseproperties), solving problems with render parity and runtime switching between flat and extruded fills. #554 - breaking
Change the units for extrusion height properties (
fill-extrusion-height,fill-extrusion-base) from "magic numbers" to meters. #3509 - breaking
Remove
mapboxgl.Controlclass and change the way custom controls should be implemented. #3497 - breaking
Remove
mapboxgl.utilfunctions:inherit,extendAll,debounce,coalesce,startsWith,supportsGeolocation. #3441 #3571 - breaking
mapboxgl.utilis deprecated and will be removed in the next release. #1408
Release note
Breaking changes
- breaking
Replace
fill-extrude-heightandfill-extrude-baseproperties offillrender type with a separatefill-extrusiontype (with correspondingfill-extrusion-heightandfill-extrusion-baseproperties), solving problems with render parity and runtime switching between flat and extruded fills. #554 - breaking
Change the units for extrusion height properties (
fill-extrusion-height,fill-extrusion-base) from "magic numbers" to meters. #3509 - breaking
Remove
mapboxgl.Controlclass and change the way custom controls should be implemented. #3497 - breaking
Remove
mapboxgl.utilfunctions:inherit,extendAll,debounce,coalesce,startsWith,supportsGeolocation. #3441 #3571 - breaking
mapboxgl.utilis deprecated and will be removed in the next release. #1408
New features and improvements
Tons of performance improvements that combined make rendering up to 3 times faster, especially for complex styles. #3485 #3489 #3490 #3491 #3498 #3499 #3501 #3510 #3514 #3515 #3486 #3527 #3574 ⚡️⚡️⚡️
🈯 Added vertical text writing mode for languages that support it. #3438
🈯 Improved line breaking of Chinese and Japanese text in point-placed labels. #3420
Reduce the default number of worker threads (
mapboxgl.workerCount) for better performance. #3565Automatically use
categoricalstyle function type when input values are strings. #3384Improve control buttons accessibility. #3492
Remove geolocation button if geolocation is disabled (e.g. the page is not served through
https). #3571Added
Map#getMaxZoomandMap#getMinZoommethods #3592
Bugfixes
Fix several line dash rendering bugs. #3451
Fix intermittent map flicker when using image sources. #3522
Fix incorrect rendering of semitransparent
backgroundlayers. #3521Fix broken
raster-fade-durationproperty. #3532Fix handling of extrusion heights with negative values (by clamping to
0). #3463Fix GeoJSON sources not placing labels/icons correctly after map rotation. #3366
Fix icon/label placement not respecting order for layers with numeric names. #3404
Fix
queryRenderedFeaturesworking incorrectly on colliding labels. #3459Fix a bug where changing extrusion properties at runtime sometimes threw an error. #3487 #3468
Fix a bug where
map.loaded()always returnedtruewhen using raster tile sources. #3302Fix a bug where moving the map out of bounds sometimes threw
failed to invert matrixerror. #3518Fixed
queryRenderedFeaturesthrowing an error if no parameters provided. #3542Fixed a bug where using multiple
\nin a text field resulted in an error. #3570