[!IMPORTANT] A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to uncontrolled storage growth, potentially degrading system performance or causing complete unusability if disk space is exhausted. The required version for upgrade is 11.19.2, 11.20.2 or any version from 11.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.

Dependencies

• Update gl-native to v11.19.1, common to v24.19.1.

11.20.0-rc.1 March 03, 2026

Features ✨ and improvements 🏁

• [compose] Add declarative animation API to experimental Marker composable with two animation triggers: appearAnimation and disappearAnimation. Each trigger accepts a list of MarkerAnimationEffect including wiggle (pendulum rotation), scale, fadeIn, and fadeOut. Effects can be customized with parameters (e.g., scale(from = 0.5f, to = 1.5f), fade(from = 0.5f, to = 1.0f)) and combined for rich animations. See MarkersActivity example for usage.
• Improve FPS statistics logging when mapView.setOnFpsChangedListener() is used with separate tracking for frame pacing skips and missed render frames for better performance debugging.

Bug fixes 🐞

• Fix MapSurface.setMaximumFps not working correctly on secondary displays (e.g. Android Auto). Use Context.getDisplay() on API 30+ to get the actual display refresh rate instead of always using the primary display's rate.
• Fix PointAnnotationManager.iconImageBitmap setter not registering the bitmap image with the style, causing group-level bitmap icons to be invisible.
• Fix feature cutout artifacts at route overlaps.
• Fix a data race condition for FillExtrusion layer.
• Fix several issues related to runtime symbol appearances switches.
• Fix disappearing icons after reducing memory use.
• Fix landmark POI image loads causes relayout for unrelated layers.
• Fix tilestore eviction logic to not block tilestore thread completely.
• Fix out-of-bounds issue for elevated line caused by an incorrect clipping result.

Dependencies

• Update gl-native to v11.20.0-rc.1, common to v24.20.0-rc.1.

11.17.2 February 24, 2026

Bug fixes 🐞

• Avoid placing occlusion layers after location indicator layer.
• Properly handle CoordinateBounds during conversion to internal type.

Dependencies

• Update gl-native to v11.17.2, common to v24.17.2.

[!IMPORTANT] A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to uncontrolled storage growth, potentially degrading system performance or causing complete unusability if disk space is exhausted. The required version for upgrade is 11.19.2, 11.20.2 or any version from 11.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.

11.19.0 February 24, 2026

Features ✨ and improvements 🏁

• Introduce new AnnotationConfig#slotName property to allow to specify a slot to position annotation layer.
• Introduce experimental queryRenderedRasterValues API for querying the rendered raster values on the map at a specific screen coordinate.
• Deprecate Tilestore.create(path: String) instead use TileStore.setRootPath().
• Improve data serialization speed when using LineString or MultiPoint in GeoJsonSource.
• Introduce new LineLayer.lineElevationGroundScale property to scale elevated lines with terrain exaggeration.
• Promote elevated lines properties to stable: LineLayer.lineZOffset and LineLayer.lineElevationReference.
• Introduce experimental SymbolScaleBehavior API to automatically scale map symbols (icons and text) based on system accessibility text size settings. Set MapboxMap.symbolScaleBehavior property to configure: SymbolScaleBehavior.system (automatic scaling), SymbolScaleBehavior.system(mapping) (custom mapping function), or SymbolScaleBehavior.fixed(scaleFactor) (fixed scale, default is 1.0). Valid scale factor range is [0.8, 2.0]. Automatic scaling is opt-in; symbols default to fixed 1.0x scale.
• General fixes and performance improvements.

Bug fixes 🐞

• Fix rare scenario where map render surface size was wrong.
• Respect animationDurationMs when custom OverviewViewportStateOptions.animationDurationMs is set.
• Fix point View Annotation flickering and hiding on moving anchor out of screen.
• Fixed a potential leak of animators, which resulted in the absence of MapIdle events.
• Fix elevated line bevel join artifacts at sharp corners.
• [compose] Improved reliability of attribution list updates on source change.
• Fix duplicate name detection bug in symbol appearance conversion.
• Fix a crash when using feature dependent appearances with images and default appearance image is empty.

Dependencies

• Update gl-native to v11.19.0, common to v24.19.0.

11.19.0-rc.1 February 12, 2026

Features ✨ and improvements 🏁

• Improve data serialization speed when using LineString or MultiPoint in GeoJsonSource.
• Introduce new LineLayer.lineElevationGroundScale property to scale elevated lines with terrain exaggeration.
• Promote elevated lines properties to stable: LineLayer.lineZOffset and LineLayer.lineElevationReference.
• Introduce experimental SymbolScaleBehavior API to automatically scale map symbols (icons and text) based on system accessibility text size settings. Set MapboxMap.symbolScaleBehavior property to configure: SymbolScaleBehavior.system (automatic scaling), SymbolScaleBehavior.system(mapping) (custom mapping function), or SymbolScaleBehavior.fixed(scaleFactor) (fixed scale, default is 1.0). Valid scale factor range is [0.8, 2.0]. Automatic scaling is opt-in; symbols default to fixed 1.0x scale.
• General fixes and performance improvements.

Bug fixes 🐞

• Fixed a potential leak of animators, which resulted in the absence of MapIdle events.
• Fix elevated line bevel join artifacts at sharp corners.
• [compose] Improved reliability of attribution list updates on source change.

Dependencies

• Update gl-native to v11.19.0-rc.1, common to v24.19.0-rc.1.

[!IMPORTANT] A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to uncontrolled storage growth, potentially degrading system performance or causing complete unusability if disk space is exhausted. The required version for upgrade is 11.18.3, 11.19.2, 11.20.2 or any version from 11.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.

11.18.2 February 10, 2026

Bug fixes 🐞

• Fix disappearing icons after reducing memory use.
• Fix Point View Annotation flickering and hiding on moving anchor out of screen

Dependencies

• Update gl-native to v11.18.2, common to v24.18.2.

[!IMPORTANT] A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to uncontrolled storage growth, potentially degrading system performance or causing complete unusability if disk space is exhausted. The required version for upgrade is 11.18.3, 11.19.2, 11.20.2 or any version from 11.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.

Bug fixes 🐞

• Fix symbol layers overlapping the location indicator when symbol occlusion is enabled.
• Fixed an LOD (level of detail) issue where map tiles could disappear at certain zoom and pitch combinations.

Dependencies

• Update gl-native to v11.18.1, common to v24.18.1.

Features ✨ and improvements 🏁

• Introduce experimental queryRenderedRasterValues API for querying the rendered raster array value at a point on the map.
• Introduce new AnnotationConfig#slotName property to allow to specify a slot to position annotation layer.
• Introduce experimental queryRenderedRasterValues API for querying the rendered raster values on the map at a specific screen coordinate.
• Deprecate Tilestore.create(path: String) instead use TileStore.setRootPath().

Bug fixes 🐞

• Fix rare scenario where map render surface size was wrong.
• Respect animationDurationMs when custom OverviewViewportStateOptions.animationDurationMs is set.
• Fix point View Annotation flickering and hiding on moving anchor out of screen.

Dependencies

• Update gl-native to v11.19.0-beta.1, common to v24.19.0-beta.1.

[!IMPORTANT] A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to uncontrolled storage growth, potentially degrading system performance or causing complete unusability if disk space is exhausted. The required version for upgrade is 11.18.3, 11.19.2, 11.20.2 or any version from 11.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.

Breaking changes ⚠️

• Remove line-cutout-width and change line-cutout-opacity default to 1.0

Features ✨ and improvements 🏁

• Add ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.
• Add Standard Style color and 3D configuration options: colorBuildings, colorCommercial, colorEducation, colorIndustrial, colorLand, colorMedical, show3dBuildings, show3dFacades, show3dLandmarks, and show3dTrees.
• Introduce experimental AttributionControl composable function that exposes AttributionState programmatically, enabling developers to build custom Attribution UI outside of the map while maintaining compliance with Mapbox ToS requirements.
• Introduce experimental indoor floor selector plugin. The plugin is not included in the default plugin list and must be explicitly added to MapInitOptions.plugins. It requires a style with indoor data and special access to indoor mapping features. To request more information, please use this form.
• Add experimental shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.
• [tile_store] Add TileStore.setRootPath() method to set tilestore path to be used by default.
• Faster polygon triangulation for complex polygons.
• Improved handling of occluded symbols with text-occlusion-opacity and icon-occlusion-opacity properties.
• General fixes and performance improvements.

Bug fixes 🐞

• Fix userData payload for onSourceDataLoaded event during GeoJSON partial update.
• Fix guard rail placement.
• Fix changes in brightness not always getting applied.
• Fix leaking Vertex Array Objects.
• Reset style fog, snow and rain impl when switching to a new style.
• Fix rendering artefacts when persistent buffer mapping is enabled.
• Fix Coercion expression possibleOutputs result for Array type.
• Fix a crash when jumping between different projections.
• Fixes for placements with icon-optional, text-optional, and missing parts.

Dependencies

• Update gl-native to v11.18.0, common to v24.18.0.

11.18.0-beta.1 December 17, 2025

Breaking changes ⚠️

• Remove line-cutout-width and change line-cutout-opacity default to 1.0

Features ✨ and improvements 🏁

• Add ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.
• Add Standard Style color and 3D configuration options: colorBuildings, colorCommercial, colorEducation, colorIndustrial, colorLand, colorMedical, show3dBuildings, show3dFacades, show3dLandmarks, and show3dTrees.
• Introduce experimental AttributionControl composable function that exposes AttributionState programmatically, enabling developers to build custom Attribution UI outside of the map while maintaining compliance with Mapbox ToS requirements.
• Introduce experimental indoor floor selector plugin. The plugin is disabled by default and requires a style with indoor data and special access to indoor mapping features.
• Add experimental shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.
• [tile_store] Add method to set tilestore path to be used by default.
• Faster polygon triangulation for complex polygons.
• General fixes and performance improvements.

Bug fixes 🐞

• Fix userData payload for onSourceDataLoaded event during GeoJSON partial update.
• Fix guard rail placement.
• Fix changes in brightness not always getting applied.
• Fix leaking Vertex Array Objects.
• Reset style fog, snow and rain impl when switching to a new style.
• Fix rendering artefacts when persistent buffer mapping is enabled.
• Fix Coercion expression possibleOutputs result for Array type.
• Fix a crash when jumping between different projections.

Dependencies

• Update gl-native to v11.18.0-beta.1, common to v24.18.0-beta.1.

11.17.1 December 11, 2025

Bug fixes 🐞

• Reset style fog, snow and rain impl when switching to a new style.
• Fix changes in brightness not always getting applied.
• Fix occlusion of location indicator in tunnels.
• Fix leaking Vertex Array Objects.

Dependencies

• Update gl-native to v11.17.1, common to v24.17.1.

Breaking changes ⚠️

• Require passing required argument to the constructor of experimental GeofencingState.Builder, GeofencingError.Builder, GeofencingEvent.Builder and GeofencingOptions.Builder APIs.

Features ✨ and improvements 🏁

• Promote Geofencing APIs to stable, remove MapboxExperimental annotations from Geofencing APIs.
• Add TileStore improvements and optimizations.
• Promote ModelLayer to stable.
• Add SymbolLayer.occlusionOpacityMode, SymbolLayer.iconColorBrightnessMax, SymbolLayer.iconColorBrightnessMin, SymbolLayer.iconColorContrast properties.
• Add FillExtrusionLayer.castShadows property.
• Add GeoJsonSource.minZoom property.
• Add RasterArraySource.volatile experimental property.
• Make line-emissive-strength property data-driven.
• Add experimental MapboxMap.setFeatureStateExpression(), removeFeatureStateExpression(), and resetFeatureStateExpressions() APIs to efficiently update feature state for multiple features at once using expressions.
• Improved error reporting for offline tile region downloads on Android.
• Enhanced reliability of network connections by improving how Cronet timeouts are handled.
• Added experimental MapOptions.Builder.scaleFactor() for scaling icons and texts.
• Add click gesture support to Marker composable with onClick parameter
• Introduced ScaleBarSettings.distanceUnits property supporting metric, imperial, and nautical units, replacing the boolean isMetricUnits property.
• Added fuelingStationModePointOfInterestLabels configuration option to Mapbox Standard and Standard Satellite styles. Control the visibility of fuel station and electric charging station POI labels with options: "default" (shows both), "fuel" (fuel stations only), "electric" (charging stations only), or "none" (hides both).
• Introduce experimental support for Appearances. The Appearances layer property defines sets of appearance objects used to quickly change the visual styling of a layer based on a condition using feature-state. See AppearancesActivity in example application for further details.
• Memory allocation improvements

Bug fixes 🐞

• Fix config expression evaluation to properly check dependencies in nested value expressions.
• Fix issue with shadows showing up on top of tunnel roads.
• Fix view-aligned symbols with road elevation being cutout.
• Fix camera listener not unsubscribed when disabling ScaleBar via updateSettings { enabled = false }
• Fixed a crash when switching map styles quickly.
• Fixed a threading bug to eliminate 3D rendering issues and instability.
• Internal fixes and performance improvements.
• Fix multiple crashes during style switches related to terrain rendering, texture management, and image cleanup.
• Fix line patterns not elevating properly on HD roads.
• Fix rendering of TileStore tiles when TileStore is used as disk cache and user is offline.
• Fix performance regression for distance and within expressions when processing large GeoJSON datasets.
• Fix GeoJSON tiled model disappearance during fast zoom interactions.
• Fix rendering issues when switching between globe and mercator projections.
• Logging improvements to reduce noise and duplication.

Features ✨ and improvements 🏁

• Promote Geofencing APIs to stable, remove MapboxExperimental annotations from Geofencing APIs.

Dependencies

• Update gl-native to v11.17.0-rc.3, common to v24.17.0-rc.3.

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update gl-native to v11.17.0-rc.2, common to v24.17.0-rc.2.

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update gl-native to v11.16.6, common to v24.16.6.

Features ✨ and improvements 🏁

• Promote ModelLayer to stable.
• Add SymbolLayer.occlusionOpacityMode, SymbolLayer.iconColorBrightnessMax, SymbolLayer.iconColorBrightnessMin, SymbolLayer.iconColorContrast properties.
• Add FillExtrusionLayer.castShadows property.
• Add GeoJsonSource.minZoom property.
• Add RasterArraySource.volatile experimental property.
• line-emissive-strength property is now data-driven, allowing different road types to be rendered in a single layer for improved performance
• Add experimental MapboxMap.setFeatureStateExpression(), removeFeatureStateExpression(), and resetFeatureStateExpressions() APIs to efficiently update feature state for multiple features at once using expressions.

Bug fixes 🐞

• Fix camera listener not unsubscribed when disabling ScaleBar via updateSettings { enabled = false }
• Fixed config expression evaluation to properly check dependencies in nested value expressions
• Reset style lights when switching to a new style
• Optimized shadow rendering by limiting extra tile requests to zoom levels 16 and above, improving performance at zoom 15
• Optimized fill-extrusion rendering at zoom 17-22 by preventing bucket overscaling, significantly reducing tile cache evictions and CPU overhead

Dependencies

• Update gl-native to v11.17.0-rc.1, common to v24.17.0-rc.1.

Features ✨ and improvements 🏁

• Improved error reporting for offline tile region downloads on Android.
• Enhanced reliability of network connections by improving how Cronet timeouts are handled.

Bug fixes 🐞

• Fixed a crash when switching map styles quickly.
• Fixed a threading bug to eliminate 3D rendering issues and instability.
• Internal fixes and performance improvements.

Dependencies

• Update gl-native to v11.17.0-beta.2, common to v24.17.0-beta.2.

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update gl-native to v11.16.4, common to v24.16.4.

Bug fixes 🐞

• Internal fixes and performance improvements.
• Fix multiple crashes during style switches.

Dependencies

• Update gl-native to v11.16.3, common to v24.16.3.

11.17.0-beta.1 November 05, 2025

Breaking changes ⚠️

• Require passing required argument to the constructor of experimental GeofencingState.Builder, GeofencingError.Builder, GeofencingEvent.Builder and GeofencingOptions.Builder APIs.

Features ✨ and improvements 🏁

• Added experimental MapOptions.Builder.scaleFactor() for scaling icons and texts.
• Add click gesture support to Marker composable with onClick parameter
• Introduced ScaleBarSettings.distanceUnits property supporting metric, imperial, and nautical units, replacing the boolean isMetricUnits property.
• Added fuelingStationModePointOfInterestLabels configuration option to Mapbox Standard and Standard Satellite styles. Control the visibility of fuel station and electric charging station POI labels with options: "default" (shows both), "fuel" (fuel stations only), "electric" (charging stations only), or "none" (hides both).
• Introduce experimental support for Appearances. The Appearances layer property defines sets of appearance objects used to quickly change the visual styling of a layer based on a condition using feature-state. See AppearancesActivity in example application for further details.
• Memory allocation improvements

Bug fixes 🐞

• Fix multiple crashes during style switches related to terrain rendering, texture management, and image cleanup.
• Fix line patterns not elevating properly on HD roads.
• Fix rendering of TileStore tiles when TileStore is used as disk cache and user is offline.
• Fix performance regression for distance and within expressions when processing large GeoJSON datasets.
• Fix GeoJSON tiled model disappearance during fast zoom interactions.
• Fix rendering issues when switching between globe and mercator projections.
• Logging improvements to reduce noise and duplication.

Dependencies

• Update gl-native to v11.17.0-beta.1, common to v24.17.0-beta.1.