Support symbol paint properties in appearances — symbol layers can now use feature-dependent appearances for paint properties (not only layout), enabling richer per-feature styling of text and icons.
Improve rendering performance of feature cutouts — optimized depth sampling in the cutout shader yields noticeably smoother rendering when feature cutouts are enabled (e.g. elevated route with cutouts).
[tile_store] Evict tiles based on LRU and optimize eviction — the default eviction policy now uses least-recently-used instead of expiration-based scoring, keeping frequently-viewed tiles around longer and making cleanup passes faster.
[tile_store] TileStore can now store 3D landmark/navigation tile content types, unblocking their use in offline regions.
[tile_store] Add support for USB import radius — new import parameter for seeding offline tile packs from USB media within a configurable radius.
Settings can be set on startup — MapboxCommon now loads persistent_settings.json and non_persistent_settings.json from the app data path at startup, allowing configuration changes without an app rebuild.

Bug fixes 🐞

Fix build issue for Objective-C consumers using Xcode 26 / Swift 6.
Fix scale-factor applied twice to icon with feature-dependent icon-size — icons using a data-driven icon-size no longer render over-sized under non-default scale factors.
Fix fog range for custom FOVs in globe view — the globe no longer washes out in fog at small FOV changes; default globe fog range was retuned for more natural appearance.
Fix for broken files in gl-native cache — the tile store worker now handles a code path that could leave corrupted entries in the gl-native disk cache, eliminating related load failures.
Prevent tilestore crash on shutdown — fixed a use-after-free in the tile store worker that could crash the app when the tile store was torn down while work was still in flight.
Fix 3D models occasionally not rendering on first load on some devices, caused by background shader compilation not signaling the renderer when compilation completed.
Fix a crash in ConfigExpression where dereferencing an empty optional caused undefined behaviour.

Dependencies

Update MapboxCommon to 24.23.0.
Update MapboxCoreMaps to 11.23.0.

Dependency requirements

Compatible version of Xcode: 16.4

v11.23.0 ↗

viaMapbox Maps Android

11.23.0 April 29, 2026

Features ✨ and improvements 🏁

Support symbol paint properties in appearances — symbol layers can now use feature-dependent appearances for paint properties (not only layout), enabling richer per-feature styling of text and icons.
Improve rendering performance of feature cutouts — optimized depth sampling in the cutout shader yields noticeably smoother rendering when feature cutouts are enabled (e.g. elevated route with cutouts).
TileStore can now store 3D landmark/navigation tile content types, unblocking their use in offline regions.
Add support for USB import radius in TileStore — new import parameter for seeding offline tile packs from USB media within a configurable radius.
Evict tiles based on LRU and optimize eviction — the default eviction policy now uses least-recently-used instead of expiration-based scoring, keeping frequently-viewed tiles around longer and making cleanup passes faster.
Settings can be set on startup — the SDK now loads persistent_settings.json and non_persistent_settings.json from the app's internal storage directory at startup, allowing configuration changes without an app rebuild.

Bug fixes 🐞

Fix attribution links accepting non-HTTP URI schemes.
Fix a potential file descriptor leak that could cause resource exhaustion.
Fix icons appearing at incorrect size when icon-size is data-driven and a non-default scale factor is applied.
Fix fog incorrectly obscuring the globe when using a custom field of view.
Fix tile data corruption causing integrity check failures for small tiles stored in the offline cache.
Fix a crash that could occur when the tile store is destroyed while downloads are still being processed.
Fix 3D models occasionally not rendering on first load on some devices, caused by background shader compilation not signaling the renderer when compilation completed.
Fix a crash in ConfigExpression where dereferencing an empty optional caused undefined behaviour.
[compose] Fixed Composition leak in ViewAnnotation when annotations are removed from the map.
[gestures] Fixed interaction leak in setGesturesManager causing native map interactions to accumulate.
[gestures] Added post-cleanup guard to prevent re-registering interactions or listeners after plugin cleanup.

Dependencies

Update gl-native to v11.23.0, common to v24.23.0.

Apr 29, 2026

v3.23.0 ↗

viaMapbox GL JS

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.22.2 ↗

viaMapbox Navigation iOS

Packaging

MapboxNavigationCore now requires MapboxMaps v11.22.1
MapboxNavigationCore now requires MapboxNavigationNative v324.22.1

Bug fixes 🐞

Fix build issue for Objective-C consumers using Xcode 26 / Swift 6.

Apr 28, 2026

v11.22.1 ↗

viaMapbox Maps Android

11.22.1 April 28, 2026

Bug fixes 🐞

[gestures] Fixed interaction leak in setGesturesManager causing native map interactions to accumulate.
[gestures] Added post-cleanup guard to prevent re-registering interactions or listeners after plugin cleanup.

Dependencies

Update gl-native to v11.22.1, common to v24.22.1.

v11.22.1 ↗

viaMapbox Maps iOS

Bug fixes 🐞

Fix build issue for Objective-C consumers using Xcode 26 / Swift 6.

Dependencies

Update MapboxCommon to 24.22.1.
Update MapboxCoreMaps to 11.22.1.

Dependency requirements:

Compatible version of Xcode: 16.4

Apr 24, 2026

v11.21.3 ↗

viaMapbox Maps iOS

Bug fixes 🐞

Fix above-ground route line not rendering over tunnel geometry when cutout is active.
Fix rendering artifacts on feature cutout geometries caused by incorrect shader clipping.
Fix a potential crash in style configuration expression evaluation when a config value is unset.

Dependencies

Update MapboxCommon to 24.21.3.
Update MapboxCoreMaps to 11.21.3.

Dependency requirements:

Compatible version of Xcode: 16.4

v11.21.3 ↗

viaMapbox Maps Android

11.21.3 April 23, 2026

Bug fixes 🐞

Fix above-ground route line not rendering over tunnel geometry when cutout is active.
Fix rendering artifacts on feature cutout geometries caused by incorrect shader clipping.
Fix a potential crash in style configuration expression evaluation when a config value is unset.

Dependencies

Update gl-native to v11.21.3, common to v24.21.3.

Apr 17, 2026

v3.22.0 ↗

viaMapbox Navigation iOS

Packaging

MapboxNavigationCore now requires MapboxMaps v11.22.0
MapboxNavigationCore now requires MapboxNavigationNative v324.22.0

Map

Fixed an issue where a route could be drawn truncated when restarting a navigation session, a regression from the v3.20.0. This will cause the traversed route line to reappear when switching to an alternative route and back.

MapboxDirections

Added RouteNotification type representing the notification object from the Directions API. RouteLeg now exposes a notifications property ([RouteNotification]?) that decodes constraint violation and alert notifications returned alongside route legs.

v3.22.0 ↗

viaMapbox GL JS