v11.18.0-beta.1

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.

v11.17.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.

v11.17.0

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.

v11.17.0-rc.3

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.

v11.17.0-rc.2

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

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

v11.16.6

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

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

v11.17.0-rc.1

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.

v11.17.0-beta.2

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.

v11.16.4

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

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

v11.16.3

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.