Mapbox Release Notes
Last updated: Apr 10, 2026
Mapbox Products
All Mapbox Release Notes (20)
- Apr 17, 2026
- Date parsed from source:Apr 17, 2026
- First seen by Releasebot:Apr 10, 2026
- Modified by Releasebot:Apr 17, 2026
v3.22.0
Mapbox GL JS fixes PowerVR crashes, nested clip layer scopes, and other rendering and build issues.
Bug fixes 🐞
- Fix a crash on PowerVR devices.
- Fix nested scopes support in clip layers.
- Fix Webpack warning on dynamic imports.
- Skip sub-pixel line dilution for intentionally thin lines.
- Skip map-sessions request when baseApiUrl is not a Mapbox host.
- Apr 2, 2026
- Date parsed from source:Apr 2, 2026
- First seen by Releasebot:Mar 27, 2026
- Modified by Releasebot:Apr 2, 2026
v3.21.0
Mapbox GL JS adds the TileProvider API with official PMTiles support, experimental line-blend-mode rendering, and faster map, symbol, and indoor loading. It also fixes several rendering and control bugs, while streamlining distribution with a few breaking changes.
Features and improvements ✨
- Introduce the TileProvider API, a mechanism for extending GL JS with custom vector tile providers.
- Add first-class support for PMTiles via the new TileProvider API and an official plugin (
mapbox-gl-pmtiles-provider.js) that loads on demand. - Add experimental line-blend-mode property for rendering lines using additive or multiply blending.
- Slightly improve overall map loading times.
- Improve symbol layer rendering performance (by adopting Uniform Buffer Objects for data-driven properties).
- Improve indoor maps loading performance.
Bug fixes 🐞
- Fix dragging gesture not working on the compass control.
- Various fixes and improvements for the Appearances API.
- Fix an edge case when combining custom icons with images included in the style's sprite.
- Fix setWorldview not updating layout properties correctly.
- Fix an issue when rendering stacked underground 3D roads.
- Fix line dashes with non-integer total array lengths.
- Fix various rendering issues when using *-cutoff-fade-range properties.
- Fix clip layer not clipping fill-extrusion ambient occlusion.
Breaking changes ⚠️
- Removed mapbox-gl-unminified.js bundle in the distribution — please switch to either mapbox-gl.js, mapbox-gl-dev.js, or the new esm-min/mapbox-gl.js ESM bundle.
- Removed spriteFormat Map option — now Mapbox styles will always use vector icons, while non-Mapbox styles will continue using classic raster sprites.
All of your release notes in one feed
Join Releasebot and get updates from Mapbox and hundreds of other software products.
- Mar 12, 2026
- Date parsed from source:Mar 12, 2026
- First seen by Releasebot:Mar 6, 2026
- Modified by Releasebot:Mar 12, 2026
v3.20.0
Mapbox boosts memory efficiency for symbol layers across tiles and fixes icon display, theme changes, and Appearances API symbol rendering.
Features and improvements ✨
Improve memory efficiency by sharing image resources for symbol layers across map tiles.
Bug fixes 🐞
Fix icons disappearing when changing the color theme.
Fix display of symbols added via the Appearances runtime API.
Original source - Mar 6, 2026
- Date parsed from source:Mar 6, 2026
- First seen by Releasebot:Mar 6, 2026
v3.20.0-rc.2
Mapbox patches a bug that hides icons when changing color themes, improving visual consistency.
- Mar 6, 2026
- Date parsed from source:Mar 6, 2026
- First seen by Releasebot:Mar 6, 2026
[email protected]: v3.20.0 rc.2 (internal-10798)
Mapbox delivers a bug fix release addressing atlas reuse issues, bumps versions, and updates the changelog.
This PR includes the fix for the atlas reuse bugs, bumps the versions and updates the changelog
cc @mapbox/gl-js
GitOrigin-RevId: c56afd985cfaf33877a36fc038b48416740f6590
Original source - Mar 4, 2026
- Date parsed from source:Mar 4, 2026
- First seen by Releasebot:Mar 5, 2026
v3.19.1
Bug fixes 🐞
Removed the unused @types/mapbox__point-geometry package that was causing some Typescript builds to fail
Original source - Feb 25, 2026
- Date parsed from source:Feb 25, 2026
- First seen by Releasebot:Feb 25, 2026
v3.19.0
Mapbox GL JS 3.19.0 adds elevated line properties to stable, experimental size scale ranges, new Map scale factor methods, terrain-aware line scaling, async model loading, and near-clip offset controls. Includes bug fixes for raster, lines, and rendering stability.
3.19.0
Features and improvements ✨
- Promote elevated lines properties to stable: line-z-offset and line-elevation-reference.
- Add experimental text-size-scale-range and icon-size-scale-range style properties.
- Add experimental Map#setScaleFactor/Map#getScaleFactor methods for controlling symbol layer scaling.
- Apply global scale factor to images within text-field.
- Fix z-fighting for elevated raster layers.
- Add raster-elevation-reference paint property to elevate raster layers relative to ground instead of sea level.
- Add line-elevation-ground-scale layout property to scale elevated lines with terrain exaggeration.
- Use native async/await when loading models. Note: Please ensure GL JS is excluded from transpilation in your build setup.
- Explicitly state minimum supported browser versions in browserslist.
- Support pitch and distance expressions in filters.
- Support incremental updates when using setFeatureState.
- Add experimental Map#setNearClipOffset/Map#getNearClipOffset methods to control the near clip offset when ortohographic projections are used.
Bug fixes 🐞
- Fix RasterArrayTileSource#reload() not working correctly.
- Add request cancellation support to the ModelSource.
- Fix flickering of aliased thin lines.
- Fix elevated line bevel join artifacts at sharp corners.
- Fix regressions in NavigationControl.
- Fix namespace conflicts in different featuresets' selectors.
- Recalculate layers with visibility: none in case properties were changed.
- Fix bug in border update logic of fill-extrusion layer, overriding clip layer's behaviour.
- Fix empty tiles on non-integer maxZoom when terrain was used.
- Fix prototype pollution via Style JSON.
- Feb 11, 2026
- Date parsed from source:Feb 11, 2026
- First seen by Releasebot:Feb 11, 2026
v3.19.0-beta.2
Features and improvements ✨
- Promote elevated lines properties to stable: line-z-offset and line-elevation-reference.
- Add experimental text-size-scale-range and icon-size-scale-range style properties.
- Add experimental Map#setScaleFactor/Map#getScaleFactor methods for controlling symbol layer scaling.
- Apply global scale factor to images within text-field.
Bug fixes 🐞
- Fix RasterArrayTileSource#reload() not working correctly.
- Add request cancellation support to the ModelSource.
- Fix flickering of aliased thin lines.
- Fix elevated line bevel join artifacts at sharp corners.
- Jan 29, 2026
- Date parsed from source:Jan 29, 2026
- First seen by Releasebot:Jan 29, 2026
v3.19.0-beta.1
New elevation features add raster-elevation-reference and line-elevation-ground-scale for terrain-aware visuals. Async model loading and a build note improve performance and compatibility with browsers. Bug fixes cover NavigationControl regressions, selector conflicts, and fill-extrusion border logic.
Features and improvements ✨
- Fix z-fighting for elevated raster layers.
- Add raster-elevation-reference paint property to elevate raster layers relative to ground instead of sea level.
- Add line-elevation-ground-scale layout property to scale elevated lines with terrain exaggeration.
- Use native async/await when loading models. Note: Please ensure GL JS is excluded from transpilation in your build setup.
- Explicitly state minimum supported browser versions in browserslist.
Bug fixes 🐞
- Fix regressions in NavigationControl.
- Fix namespace conflicts in different featuresets' selectors.
- Recalculate layers with visibility: none in case properties were changed.
- Fix bug in border update logic of fill-extrusion layer, overriding clip layer's behaviour.
- Jan 22, 2026
- Date parsed from source:Jan 22, 2026
- First seen by Releasebot:Jan 23, 2026
v3.18.1
Features and improvements ✨
- Add support for visibility property in clip layers.
- Improve raster-color precision for fine-grained value ranges.
Bug fixes 🐞
- Fix color interpolation throwing errors in edge cases.
- Fix appearances with no icon-size.
- Fix disappearing symbols when used with elevated raster layers.
- Jan 14, 2026
- Date parsed from source:Jan 14, 2026
- First seen by Releasebot:Jan 14, 2026
v3.18.0
New release brings scaleFactor for text field images, GeolocateControl enhancements, and richer appearance options plus shadow and model layer controls. Numerous bug fixes improve interactions, rendering, and stability across maps.
Features and improvements ✨
- Add scaleFactor support for images within text-field.
- Add showButton option to GeolocateControl that allows hiding the control button.
- Add followUserLocation option and setFollowUserLocation method to GeolocateControl to control whether the map follows the user's location.
- Improve GeolocateControl timeout handling.
- Add support for text-rotate, text-size, and text-offset properties in appearances.
- Add shadow-draw-before-layer property to directional light, allowing control over shadow draw order in the layer stack.
- Add model-allow-density-reduction property to model layers. (h/t @JoshuaJMoore)
Bug fixes 🐞
- Fix interaction handlers not working on model layers.
- Fix stretchable icons without icon-text-fit rendering with an incorrect size.
- Fix icon-size not working correctly with coalesce expressions.
- Fix raster-color interpolation when using nearest raster-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 GeolocateControl error event (h/t @lucavb).
- Fix an error when querying multipolygons in dynamic: true mode.
- Fix AttributionControl links sanitization.
- Fix appearances with no icon-size using the default value instead of the layout-defined one.
- Fix updates to model source via ModelSource.setModels while 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-spec for direct imports.
- Jan 5, 2026
- Date parsed from source:Jan 5, 2026
- First seen by Releasebot:Jan 5, 2026
v3.18.0-beta.2
New GeolocateControl options add hide button and follow-user features, plus improved timeout handling. Bug fixes improve icon rendering, coalesce sizing, raster ortho rendering, symbol placement, and expose error properties.
Features and improvements ✨
Add showButton option to GeolocateControl that allows hiding the control button.
Add followUserLocation option and setFollowUserLocation method to GeolocateControl to control whether the map follows the user's location.
Improve GeolocateControl timeout handling.
Bug fixes 🐞
- Fix stretchable icons without icon-text-fit rendering with an incorrect size.
- Fix icon-size not working correctly with coalesce expressions.
- 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 GeolocateControl error event (h/t @lucavb).
- Dec 18, 2025
- Date parsed from source:Dec 18, 2025
- First seen by Releasebot:Dec 19, 2025
v3.18.0-beta.1
New appearance controls for text-rotate, text-size, text-offset, plus shadow-draw-before-layer and model-allow-density-reduction. Bug fixes cover dynamic multipolygons, AttributionControl links, default icon-size, ModelSource loading, polygon clipping, and featuresets preservation.
Features and improvements
- Add support for text-rotate, text-size, and text-offset properties in appearances.
- Add shadow-draw-before-layer property to directional light, allowing control over shadow draw order in the layer stack.
- Add model-allow-density-reduction property to model layers. (h/t @ JoshuaJMoore)
Bug fixes
- Fix an error when querying multipolygons in dynamic: true mode.
- Fix AttributionControl links sanitization.
- Fix appearances with no icon-size using the default value instead of the layout-defined one.
- Fix updates to model source via ModelSource.setModels while 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-spec for direct imports.
- Dec 3, 2025
- Date parsed from source:Dec 3, 2025
- First seen by Releasebot:Dec 11, 2025
v3.17.0
New release adds experimental ESM support and data‑driven line-emissive strength, with many quality boosts for rendering and performance across raster, vector and model layers. It also fixes multiple rendering and localization issues and refines appearances and types.
Features and improvements ✨
- Add experimental ESM support.
- Make line-emissive-strength data-driven.
- Remove experimental flag from the extra_bounds property of raster and vector sources.
- Remove experimental flag from model layer.
- Remove experimental flag from building layer.
- Improve vector icons rasterization performance.
- Improve shadow rendering performance.
- Improve building layer performance.
- Improve shader initialization performance.
Bug fixes 🐞
- Fix polygon rendering for dynamic GeoJSON sources.
- Fix raster-array layers not working on iOS < 18.4.
- Fix a performance issue for symbol layers with zero fade duration and static camera.
- Fix occasional WebGL texture warnings when rendering terrain.
- Fix features not being localized in dynamic filters when a worldview is set.
- Fix an issue with clipping models on Standard.
- Fix an issue with models flashing on setData.
- Fix an issue with incorrect scoping of models added during runtime.
- Fix line patterns not elevating properly on HD roads.
- Sanitize attributions in AttributionControl.
- Correctly support filtered features in appearances.
- Fix an issue occuring when expressions are used in appearances.
- Fix appearance optimization that resulted in wrong appearances being rendered.
- Fix appearance icons not changing when feature state changed multiple times.
- Improve TypeScript types.
- Nov 19, 2025
- Date parsed from source:Nov 19, 2025
- First seen by Releasebot:Dec 11, 2025
v3.17.0-beta.2
Features and improvements ✨
- Make line-emissive-strength data-driven.
- Remove experimental flag from the extra_bounds property of raster and vector sources.
- Various performance improvements.
Bug fixes 🐞
- Fix features not being localized in dynamic filters when a worldview is set.
- Correctly support filtered features in appearances.
- Fix an issue occuring when expressions are used in appearances.