mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
Where each line stands
Plan an upgradeLatest releases
All 197 releases3.34.2
3 Nov 20263.34.1
29 Oct 2026Improve performance on map views with CJK glyphs by moving CJK rasterization offscreen.
Improve tile load performance via optimization of style property values recalculation.
Improve rendering performance via per-frame main thread work optimizations.
Features and improvements
Improve performance on map views with CJK glyphs by moving CJK rasterization offscreen.
Improve tile load performance via optimization of style property values recalculation.
Improve rendering performance via per-frame main thread work optimizations.
Add support of *-ignore-placement and *-allow-overlap in global placement.
Add
raster-maskandraster-mask-modepaint properties so a raster layer can be clipped to, or excluded from, the geometry of a fill layer
Bug fixes
Fix coverage stencil marks including polygons for other road classes, which hid roads that should stay visible.
Fix imported styles silently rendering nothing when the import fires a non-fatal error while loading.
Fix raster tiles occasionally showing the image of a different tile after zooming or panning on a slow network.
Fix
buildinglayer filters that usedistance,withinorworldviewdropping buildings.Fix a sudden camera jump at the end of long
flyTocamera animations.Fix 0 fadeDuration symbol placement offset.
Fix
projectiondocumentation incorrectly stating that custom layers are not supported on globe.Fix per-feature symbol/line paint value update based on light changes.
3.33.0
13 Oct 2026- breaking
Right-to-left text (such as Arabic and Hebrew) is now supported out of the box, loading a small WebAssembly module the first time it appears on the map.
setRTLTextPlugin,getRTLTextPluginStatusand thePluginStatustype are removed. - breaking
The base size of icons in the
text-fieldproperty is now calculated at the tile zoom level with the largest text size. As a result, the icons can be smaller when the text size depends on the zoom level. Improve memory use & map load time, especially for 3D layers.
Breaking changes
- breaking
Right-to-left text (such as Arabic and Hebrew) is now supported out of the box, loading a small WebAssembly module the first time it appears on the map.
setRTLTextPlugin,getRTLTextPluginStatusand thePluginStatustype are removed. - breaking
The base size of icons in the
text-fieldproperty is now calculated at the tile zoom level with the largest text size. As a result, the icons can be smaller when the text size depends on the zoom level.
Features and improvements
Improve memory use & map load time, especially for 3D layers.
Improve line rendering performance by using a uniform instead of a shader permutation for
line-dasharray.Add support for offsetting a control from its corner via
map.addControl(control, {position, offset: {x, y}}).Improve 3D Lanes map load performance.
Avoid placing parent-tile symbols when using the global placement.
Extend global placement debug info.
Bug fixes
Fix a severe performance regression when updating data-driven line layers with
setPaintProperty.Fix a rendering issue when drawing thousands of data-driven lines and symbols.
Fix transparent
buildingandfill-extrusionlayers blending the same pixel twice where they cover the same buildings, making the overlap look more opaque than either layer's opacity asks for.Fix an issue with GeoJSON geometries past longitude -+360 or latitude +-85 rendering incorrectly.
Fix map-aligned
icon-rotateandtext-rotatenot being measured from true north in projections other than Mercator or globe, which misrotated symbols such as crosswalks.Fix collision boxes not matching rotated symbols that use appearances with a layout
icon-rotateortext-rotate.Fix symbol fading not finishing when using global placement.
Dependency tracking · free for 3 projects
Know when your own dependencies move
mapbox-gl published 24 releases in the last 12 months. inlinr folds the routine ones into a line and keeps the few that need you.
Advisories reach you
An email when a critical or high advisory affects a project, before the next install.
Upgrades checked first
Peer ranges, Node, ESM-only and types changes read before you bump.
Only what matters
Majors and breaking notes stay; patches and sibling bumps fold into one line.
Registry facts last checked 4 Nov 2026. Releases and advisories last read 4 Nov 2026.