releases.shpreview
Mapbox/Mapbox GL JS

Mapbox GL JS

$npx @buildinternet/releases show mapbox-gl-js
Mon
Wed
Fri
MayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases14Avg4/moVersionsv3.19.0-beta.1 → v3.23.0
Jan 27, 2025
  • Fix vector icons rendering with stretch areas on high DPI devices.
Jan 15, 2025
  • Fix issues when updating feature state on symbol layers.
  • Fix canvas source not rendering correctly after a canvas resize.
Jan 3, 2025
  • Fix the display of user-rendered images.
  • Fix a broken build issue in specific bundling configurations using Vite or ESBuild.
  • Fix the console error issue that sometimes occurs during map initialization.
Dec 23, 2024
  • Fix an error when using background patterns on styles with vector icons enabled.
  • Fix queryRenderedFeatures not working on styles with custom layers.
  • When using queryRenderedFeatures and querySourceFeatures with featureset, fix filter option to apply to featureset selectors rather than original properties, and add featureNamespace validation.
  • Fix queryRenderedFeatures missing source, sourceLayer and layer properties in resulting features where they should be present.
  • Fix small rendering artifacts on line corners when using patterns with line-join: none.
Dec 18, 2024

Breaking changes ⚠️

  • Rename featureset property to target in addInteraction and queryRenderedFeatures options.

Features and improvements ✨

  • Add experimental vector icons support.
  • Add experimental precipitation support through snow and rain style properties.
  • Add experimental features for interactive indoor maps.
  • Add to-hsla expression.
  • Add *-use-theme property to override the color theme for specific layers.
  • Add support for color-theme overrides in imports.
  • Add per-feature mouseenter, mouseover, mouseleave, and mouseout events for addInteraction.
  • Enable mixing featuresets and layers in the Map#queryRenderedFeatures.
  • Improve landmark rendering performance.
  • The clip layer is now stable and no longer marked experimental.

Bug fixes 🐞

  • Fix crash on devices with PowerVR GPUs.
  • Fix dark shade of fill-extrusion buildings caused by specific light directions.
  • Fix double shadowing on lines at ground level.
  • Fix shadow acne from 3D structures close to the ground.
  • Fix update of state-dependent features during brightness changes.
  • Fix an edge case with fill extrusions around tile borders not being updated correctly on terrain load.
  • Fix a race condition where using line-z-offset would sometimes break layer rendering order.
Dec 10, 2024

Breaking changes ⚠️

  • Rename featureset property to target in addInteraction and queryRenderedFetures options.

Features and improvements ✨

  • Add experimental features for interactive indoor maps.
  • Add experimental vector icons support.
  • Add experimental precipitation support through snow and rain style properties.
  • Add to-hsla expression.
  • Add *-use-theme property to override the color theme for specific layers.
  • Add support for color-theme overrides in imports.
  • Add per-feature mouseenter, mouseover, mouseleave, and mouseout events for addInteraction.
  • Enable mixing featuresets and layers in the Map#queryRenderedFeatures.
  • Improve landmark rendering performance.

Bug fixes 🐞

  • Fix crash on devices with PowerVR GPUs.
  • Fix dark shade of fill-extrusion buildings caused by specific light directions.
  • Fix double shadowing on lines at ground level.
  • Fix shadow acne from 3D structures close to the ground.
  • Fix update of state-dependent features during brightness changes.
Nov 12, 2024

Features and improvements ✨

  • Add experimental support for style-defined featuresets, an upcoming way to query features in Mapbox Standard and other fragment-based styles.
  • Add experimental Map addInteraction/removeInteraction methods that make it easier to manage map interactions like clicking and hovering over features.
  • Add experimental support for elevated lines with line-cross-slope and line-elevation-reference properties.
  • Add experimental scaleFactor map option and setScaleFactor method to increase map label size (useful for improving accessibility or adjusting text size for different devices).
  • Add support for using line-progress expression in non-data-driven line properties.
  • Add experimental fill-extrusion-height-alignment and fill-extrusion-base-alignment properties to control fill extrusion top/bottom alignment.
  • Improve performance of dynamic brightness changes.
  • Minor optimizations to reduce load time.

Bug fixes 🐞

  • Fix localization when setting a worldview on the Mapbox Standard style.
  • Fix raster array rendering on some Android devices.
  • Fix an issue where fill-extrusion buildings would disappear when zooming out.
  • Fix line joins for thick semi-transparent or blurred lines.
  • Improve appearance of line corners with densely placed vertices.
  • Fix anti-alising aftifacts on blurred lines.
  • Fix call stack overflow caused by repeated addImport calls.
  • Fix failures when handling non-renderable characters.
  • Fix rendering of Osage script.
  • Fix certain edge cases when using config expression in filter properties.
  • Fix patterned fill extrusions being visible with zero opacity alpha.
  • Fix data-driven symbol-z-offset not working properly.
  • Fix fill extrusions on terrain producing WebGL warnings in some cases.
  • Fix line-emissive-strength not being applied to patterned lines.
Oct 25, 2024

Features and improvements ✨

  • Minor optimizations to reduce load time.

Bug fixes 🐞

  • Fix raster array rendering on some Android devices.
  • Fix an issue where fill-extrusion buildings would disappear when zooming out.
  • Fix line joins for thick semi-transparent or blurred lines.
  • Improve appearance of line corners with densely placed vertices.
  • Fix anti-alising aftifacts on blurred lines.
  • Fix call stack overflow caused by repeated addImport calls.
  • Fix failures when handling non-renderable characters.
  • Fix the Osage script rendering.
Sep 27, 2024

Features and improvements ✨

  • Add background-pitch-alignment property of the background layer, which is set to map by default but can now be set to viewport. Useful for highlighting individual features by dimming the rest of the map with a semitransparent background.
  • Add new control positions (top, right, bottom, and left) (h/t @Ethan-Guttman).
  • Add retainPadding option for camera movement methods, which can be set to false for pre-v3.4 padding behavior.
  • Add config expression support in layer filter.
  • Add symbol elevation properties: symbol-z-offset and symbol-elevation-reference.
  • Add the fill-z-offset property for fill layers.
  • Improve Map#fitBounds for the alternative projections.
  • Improve terrain hillshade lighting anchored to viewport.
  • Improve shadow casting from 3D models.
  • Improve error messages for invalid expressions.
  • Skip landmarks rendering when the camera is inside them.
  • Improve type checking for the Map#setPaintProperty and Map#setLayoutProperty methods.
  • Allow the string event type in Map event handlers.
  • Expose RequestTransformFunction, ResourceType, and RequestParameters types.
  • Improve texture memory footprint on some platforms.

Bug fixes 🐞

  • Fix feature filtering when using 3D lights.
  • Fix pattern rendering issues on some devices at high zoom levels.
  • Fix fill-extrusion-line-width rendering for large polygons
  • Fix symbol placement ordering when symbol-z-order is set to auto.
  • Fix the issue where minzoom and maxzoom properties were ignored by clip layers.
  • Fix handling previously hidden models in clip layers.
  • Fix directional light cast-shadows property type.
  • Fix an edge case that could produce setStencilMode-related error in the console with the dev build.
  • Fix an issue where some fill extrusions could temporarily disappear when zooming quickly in certain areas.
  • Fix an edge case that could cause flickering on a far plane on high zooms.
Sep 12, 2024

Features and improvements ✨

  • Add config expression support in layer filter.
  • Add symbol elevation properties: symbol-z-offset and symbol-elevation-reference.
  • Add the fill-z-offset property for fill layers.
  • Improve Map#fitBounds for the alternative projections.
  • Improve terrain hillshade lighting anchored to viewport.
  • Improve shadow casting from 3D models.
  • Improve error messages for invalid expressions.
  • Skip landmarks rendering when the camera is inside them.
  • Improve type checking for the Map#setPaintProperty and Map#setLayoutProperty methods.
  • Allow the string event type in Map event handlers.
  • Expose RequestTransformFunction, ResourceType, and RequestParameters types.

Bug fixes 🐞

  • Fix feature filtering when using 3D lights.
  • Fix pattern rendering issues on some devices at high zoom levels.
  • Fix fill-extrusion-line-width rendering for large polygons
  • Fix symbol placement ordering when symbol-z-order is set to auto.
  • Fix the issue where minzoom and maxzoom properties were ignored by clip layers.
  • Fix handling previously hidden models in clip layers.
  • Fix directional light cast-shadows property type.
Aug 14, 2024

Features and improvements ✨

  • Add wall rendering mode to the fill-extrusion layer by introducing fill-extrusion-line-width and fill-extrusion-line-alignment properties. Set fill-extrusion-line-width to a non-zero value to render walls instead of a solid extrusion.
  • Improve initial load performance.
  • Add inner glow effect for negative circle-blur values.
  • Add raster-particle-elevation property.
  • Add support for inlining TileJSON in style source definitions using data field.
  • Improve 3D models' shadow appearance.
  • Improve performance of updating config values of a style.
  • Add more descriptive expression evaluation error messages.
  • Improve TypeScript typings.
  • Improve performance of symbol occlusion (visibility checks against terrain and 3D objects).
  • Add clip-layer-scope property to limit clip layer to a specific style fragment.
  • Add Map idle method to check whether a map is idle.

Bug fixes 🐞

  • Fix isSourceLoaded flag on sourcedata event for already loaded sources.
  • Fix firing load event when all tiles fail to load.
  • Fix performance issues when GeoJSON in dynamic mode is updated too frequently.
  • Fix GeoJSON line rendering in dynamic mode.
  • Fix rasterarray layer flickering from stale tiles cache.
  • Fix spikes when viewing terrain-enabled maps in certain environments.
  • Fix Map getLayer not working properly with custom layers.
  • Fix custom layer rendering issues on globe with high pitch.
  • Fix an issue with line-trim-offset on very long lines.
  • Fix rendering issues when ground effects overlap with line layers.
  • Fix landmark visibility issues near tile borders.
  • Fix accessibility issues with compact attribution button and logo.
Jul 31, 2024

Features and improvements ✨

  • Improve initial load performance.
  • Add inner glow effect for negative circle-blur values.
  • Add support for inlining TileJSON in style source definitions using data field.
  • Improve 3D models' shadow appearance.
  • Improve performance of updating config values of a style.
  • Add more descriptive expression evaluation error messages.
  • Improve TypeScript typings.

Bug fixes 🐞

  • Fix isSourceLoaded flag on sourcedata event for already loaded sources.
  • Fix firing load event when all tiles fail to load.
  • Fix performance issues when GeoJSON in dynamic mode is updated too frequently.
  • Fix rasterarray layer flickering from stale tiles cache.
  • Fix spikes when viewing terrain-enabled maps in certain environments.
Jul 18, 2024

Features and improvements ✨

  • Improve 3D models rendering performance.
  • Slightly improve terrain rendering performance.
  • Improve TypeScript API, including strongly typed Map event listeners, improved type narrowing, and more.

Bug fixes 🐞

  • Fix raster particle data decoding and improve rendering quality.
  • Fix 3D lighting rendering when lookup tables (LUT) image is applied.
  • Fix shadows rendering artifacts on fill-extrusion-cutoff-fade-range.
Jul 5, 2024

Revert default behavior of symbol occlusion behind terrain to maintain compatibility. Set icon-occlusion-opacity/text-occlusion-opacity properties to opt-in to new occlusion behavior.

Jul 4, 2024

Breaking changes ⚠️

  • This release marks a significant transition for GL JS, moving from Flow to TypeScript. While we have maintained backward compatibility where possible, the community typings @types/mapbox-gl are not fully compatible with the new first-class typings. Users relying on the community typings may experience breaking changes. Please remove the @types/mapbox-gl dependency and refer to the v3.5.0 migration guide for instructions on upgrading, resolving common issues, and asking questions regarding the migration to the first-class typings. We welcome your feedback and contributions to make Mapbox GL JS better.

Features and improvements ✨

  • Add color-theme property and Map setColorTheme method to enable colorization with a lookup table (LUT) images.
  • Significantly improve performance of updateData for GeoJSON sources in dynamic mode.
  • Add icon-occlusion-opacity and text-occlusion-opacity properties to fade symbols behind models and landmarks.
  • Add line-occlusion-opacity property to fade lines behind 3D objects.
  • Add experimental clip layer to filter out rendering data.
  • Add experimental line-z-offset property for a non-globe view.
  • Add model-cutoff-fade-range property to control fade out of faraway 3D buildings.
  • Improve precision of line-pattern on long lines and higher zooms.
  • Add experimental line-trim-color and line-trim-fade-range properties to customize rendering of lines trimmed with line-trim-offset.
  • Add Map getSlots method for listing available slots of a style.

Bug fixes 🐞

  • Fix a performance regression in Standard style introduced in v3.4.0.
  • Fix icon rotation during globe transition.
  • Fix GeoJSON data loss due to frequent updateData calls.
  • Improve raster-particle layer animation.
  • Fix model-front-cutoff property for Meshopt-encoded models.
  • Fix errors in the console on empty 3D tiles.
  • Fix not properly detecting fingerprinting protection when adding terrain through setTerrain.
  • Fix style.load event missing style property.
  • Fix errors when using queryRenderedFeatures on areas with missing DEM tiles when terrain is enabled.
Jun 19, 2024

Breaking changes ⚠️

  • This release marks a significant transition for GL JS, moving from Flow to TypeScript. While we have maintained backward compatibility where possible, the community typings @types/mapbox-gl are not fully compatible with the new first-class typings. Users relying on the community typings may experience breaking changes. Please remove the @types/mapbox-gl dependency and refer to the v3.5.0 migration guide for instructions on upgrading, resolving common issues, and asking questions regarding the migration to the first-class typings. We welcome your feedback and contributions to make Mapbox GL JS better.

Features and improvements ✨

  • Add a color-theme property to enable colorization with a lookup table (LUT) images.
  • Add icon-occlusion-opacity and text-occlusion-opacity properties to fade symbols behind models and landmarks.
  • Add line-occlusion-opacity property to fade lines behind 3D objects.
  • Add experimental clip layer to filter out rendering data.
  • Add experimental line-z-offset property for a non-globe view.
  • Add model-cutoff-fade-range property support to control fade out of faraway 3D buildings.

Bug fixes 🐞

  • Fix icon rotation during globe transition.
  • Fix GeoJSON data loss due to frequent updateData calls.
  • Improve raster-particle layer animation.
  • Fix padding not being applied on flyTo when prefers-reduced-motion is set.
May 24, 2024

Features and improvements ✨

  • Add dynamic: true option for GeoJSON sources that enables partial update API with source.updateData method. Further optimizations for this mode are expected in future releases.
  • Add Map setConfig, getConfig, setSchema and getSchema methods for batch setting of style configuration options.
  • Add config option for the Map constructor and setStyle methods for conveniently setting style configuration options on map initialization.
  • Add icon-color-saturation, icon-color-contrast, icon-color-brightness-min and icon-color-brightness-max to control symbol layer appearance.
  • Introduce a new line-join mode: none to improve line pattern distortions around joins.
  • Extend model-id property to support URIs (in addition to style-defined model references).
  • Expose more parameters in map devtools UI.

Bug fixes 🐞

  • Fix an issue with flyTo ignoring padding in its options.
  • Respect padding in cameraForBounds on globe view. (h/t @jonasnoki) #13126
  • Fix preloadOnly not preloading tiles from style imports.
  • Fix queryRenderedFeatures for non-integer ID in non-tiled model sources
  • Fix model-scale property for large number of 3D models.
  • Fix flickering of raster-particle layer on globe view.
  • Improve rendering of low-resolution raster-array data.
  • Fix an issue with GL JS bundle not building locally on Windows.
  • Fix multiple edge cases when using symbol-z-elevate.
  • Fix rendering issues with raster-particle layer on certain Android devices.
  • Fix shadow and lighting rendering issues in certain areas when using Mapbox Standard.
May 10, 2024

Features and improvements ✨

  • Add icon-color-saturation, icon-color-contrast, icon-color-brightness-min and icon-color-brightness-max to control symbol layer appearance.
  • Introduce a new line-join mode: none to improve line pattern distortions around joins.
  • Extend model-id property to support URIs (in addition to style-defined model references).

Bug fixes 🐞

  • Respect padding in cameraForBounds on globe view. (h/t @jonasnoki) #13126
  • Fix preloadOnly not preloading tiles from style imports.
  • Fix queryRenderedFeatures for non-integer ID in non-tiled model sources
  • Fix model-scale property for large number of 3D models.
  • Fix flickering of raster-particle layer on globe view.
  • Improve rendering of low-resolution raster-array data.
Apr 10, 2024

Features and improvements ✨

  • Add a new raster-array source type, representing a new experimental Mapbox Raster Tile format which encodes series of tiled raster data (such as weather time series).
  • Add a new raster-particle layer which animates particles of different speed and color based on underlying raster-array data.
  • Add addImport, moveImport, updateImport, and removeImport API methods.
  • Add getSlot, and setSlot API methods to control layers' slots.
  • Add landmarks and models support in queryRenderedFeatures.
  • Add raster-elevation support for tiled raster sources.
  • Add config expression support in fog.
  • Improve map loading performance.

Bug fixes 🐞

  • Fix zooming with the pitched camera and maxZoom.
  • Fix memory leak after removing the map. (h/t @kamil-sienkiewicz-asi) #13110, #13116
  • Fix broken horizon line for some camera values.
  • Fix broken globe draping after updating style with setStyle.
  • Fix the z offset when the opacity is evaluated at 0 on the zoom change.
  • Fix the format expression in the config expression.
  • Fix adding a marker to the map that is not loaded when fog is enabled.
  • Fix symbol and icon rendering order when using symbol-sort-key property.
Apr 2, 2024

Features and improvements ✨

  • Add raster particles layer.
  • Add raster-array source.
  • Add addImport, moveImport, updateImport, and removeImport API methods.
  • Add getSlot, and setSlot API methods to control layers' slots.
  • Add landmarks and models support in queryRenderedFeatures.
  • Add raster-elevation support for tiled raster sources.
  • Add config expression support in fog.
  • Improve map loading performance.

Bug fixes 🐞

  • Fix zooming with the pitched camera and maxZoom.
  • Fix memory leak after removing the map. (h/t @kamil-sienkiewicz-asi) #13110, #13116
  • Fix broken horizon line for some camera values.
  • Fix broken globe draping after updating style with setStyle.
  • Fix the z offset when the opacity is evaluated at 0 on the zoom change.
  • Fix the format expression in the config expression.
  • Fix adding a marker to the map that is not loaded when fog is enabled.
Latest
v3.23.0
Tracking Since
Jun 17, 2022
Last checked May 1, 2026