v3.23.0

Features and improvements ✨

• Improve the performance of symbol layers on old devices.
• Add TileProvider for raster and raster-dem sources, adding support for PMTiles with raster tiles.
• Enable client-side fontstack compositing by default. When multiple fonts are requested they are now fetched individually and composited on the client.
• Promote interactions API to stable.
• Add a bundler-friendly ESM bundle in the NPM package (import mapboxgl from 'mapbox-gl/esm').
• Lazy-load procedural buildings and precipitation code when using the ESM entry point.

Bug fixes 🐞

• Fix values smaller than 1 in line-dasharray not working.
• Fix a render issue where black boxes could appear instead of symbols briefly in some environments.
• Fix scale-factor being applied twice to icons with feature-dependent icon-size.
• Fix redundant WASM requests on map load when using the Standard style.
• Fix hillshade rendering issue when using Safari in private browsing mode.

v3.23.0-rc.2

Bug fixes 🐞

• Fix hillshade rendering issue when using Safari in private browsing mode.

3.23.0-rc.1

Features and improvements ✨

• Improve the performance of symbol layers on old devices.
• Add TileProvider for raster and raster-dem sources, adding support for PMTiles with raster tiles.
• Enable client-side fontstack compositing by default. When multiple fonts are requested they are now fetched individually and composited on the client.
• Promote interactions API to stable.
• Add a bundler-friendly ESM bundle in the NPM package (import mapboxgl from 'mapbox-gl/esm').
• Lazy-load procedural buildings and precipitation code when using the ESM entry point.

Bug fixes 🐞

• Fix values smaller than 1 in line-dasharray not working.
• Fix a render issue where black boxes could appear instead of symbols briefly in some environments.
• Fix scale-factor being applied twice to icons with feature-dependent icon-size.
• Fix redundant WASM requests on map load when using the Standard style.

v3.22.0

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.

v3.22.0-rc.1

Bug fixes 🐞

• Fix a crash on PowerVR devices.
• Fix nested scopes support in clip layers.
• Skip sub-pixel line dilution for intentionally thin lines.
• Skip map-sessions request when baseApiUrl is not a Mapbox host.

v3.21.0

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.

v3.21.0-rc.1

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.

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.

v3.20.0

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.

v3.20.0-rc.2

Bug fixes 🐞

• Fix icons disappearing when changing the color theme.

v3.20.0-rc.1

Features and improvements ✨

• Improve memory efficiency by sharing image resources for symbol layers across map tiles.

Bug fixes 🐞

• Fix display of symbols added via the Appearances runtime API.