---
name: Mapbox Maps iOS
slug: mapbox-maps-ios
type: github
source_url: https://github.com/mapbox/mapbox-maps-ios
organization: Mapbox
organization_slug: mapbox
total_releases: 100
latest_version: v11.23.0
latest_date: 2026-04-30
last_updated: 2026-05-01
tracking_since: 2024-12-19
canonical: https://releases.sh/mapbox/mapbox-maps-ios
organization_url: https://releases.sh/mapbox
---

<Release version="v11.23.0" date="April 30, 2026" published="2026-04-30T12:55:22.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.23.0">
# v11.23.0

### 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).
* [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`

</Release>

<Release version="v11.22.1" date="April 28, 2026" published="2026-04-28T14:15:14.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.22.1">
## 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`

</Release>

<Release version="v11.21.3" date="April 24, 2026" published="2026-04-24T13:19:19.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.21.3">
## 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`

</Release>

<Release version="v11.23.0-rc.1" date="April 21, 2026" published="2026-04-21T18:17:51.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.23.0-rc.1">
  ### 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).
  * [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 `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.
  
  ### Dependencies
* Update MapboxCommon to `24.23.0-rc.1`.
* Update MapboxCoreMaps to `11.23.0-rc.1`.
</Release>

<Release version="v11.21.2" date="April 17, 2026" published="2026-04-17T08:08:13.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.21.2">
## Features ✨ and improvements 🏁
*  Improve rendering performance of feature cutouts

## Bug fixes 🐞
* Fix tile cover issues for tunnels

### Dependencies
* Update MapboxCommon to `24.21.2`.
* Update MapboxCoreMaps to `11.21.2`.

### Dependency requirements:
* Compatible version of Xcode: `16.4`

</Release>

<Release version="v11.22.0" date="April 16, 2026" published="2026-04-16T14:20:32.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.22.0">
## Features ✨ and improvements 🏁

* Expose `height` and `minHeight` properties on `StandardBuildingsFeature`.
* Internal fixes and performance improvements.

## Bug fixes 🐞
* Fix old 3D puck model remaining after updating the puck model.
* Fix location indicator cutout appearing in the wrong position on devices with high pixel density.
* Fix lines with sub-pixel width being rendered thicker than intended.
* Fix tile data decompression by properly tracking compression state in tile storage.
* Fix tile store cleanup task incorrectly deleting in-progress downloads.
* Fix tunnel roads being clipped or missing near the top of the screen at high pitch angles when crossing tile boundaries.
* Fix stretchable icons used with `icon-text-fit` disappearing in some situations
* Fix dashed lines not rendering correctly when `line-dasharray` values are smaller than 1.

### Dependencies
* Update MapboxCommon to `24.22.0`.
* Update MapboxCoreMaps to `11.22.0`.

### Dependency requirements:
* Compatible version of Xcode: `16.4`

</Release>

<Release version="v11.20.3" date="April 16, 2026" published="2026-04-16T10:58:04.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.20.3">
## Bug fixes 🐞

* Fix tile data decompression by properly tracking compression state in tile storage.

### Dependencies
* Update MapboxCommon to `24.20.3`.
* Update MapboxCoreMaps to `11.20.3`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.21.1" date="April 10, 2026" published="2026-04-10T15:04:50.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.21.1">
## Bug fixes 🐞

* Internal fixes and performance improvements.

### Dependencies
* Update MapboxCommon to `24.21.1`.
* Update MapboxCoreMaps to `11.21.1`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.19.6" date="April 10, 2026" published="2026-04-10T14:53:12.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.19.6">
## Bug fixes 🐞

* Internal fixes and performance improvements.

### Dependencies
* Update MapboxCommon to `24.19.6`.
* Update MapboxCoreMaps to `11.19.6`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.22.0-rc.1" date="April 9, 2026" published="2026-04-09T09:35:38.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.22.0-rc.1">
## Features ✨ and improvements 🏁

* Expose `height` and `minHeight` properties on `StandardBuildingsFeature`.
* Internal fixes and performance improvements.

## Bug fixes 🐞

* Fix old 3D puck model remaining after updating the puck model.
* Fix location indicator cutout appearing in the wrong position on devices with high pixel density.
* Fix lines with sub-pixel width being rendered thicker than intended.
* Fix tile data decompression by properly tracking compression state in tile storage.
* Fix tile store cleanup task incorrectly deleting in-progress downloads.
* Resolve an issue where display link did not run for CarPlay Dashboard or Instrument Cluster scenes. 
   The display link state is now correctly managed by caching the connected scene of the map view, supporting cases where the standard windowScene reference is unavailable (as in CarPlay dashboard configurations).

### Dependencies
* Update MapboxCommon to `24.22.0-rc.1`.
* Update MapboxCoreMaps to `11.22.0-rc.1`.

### Dependency requirements:
* Compatible version of Xcode: `16.4`

</Release>

<Release version="v11.19.5" date="April 7, 2026" published="2026-04-07T09:12:48.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.19.5">
## Bug fixes 🐞

* Internal fixes and performance improvements.

### Dependencies
* Update MapboxCommon to `24.19.5`.
* Update MapboxCoreMaps to `11.19.5`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`
</Release>

<Release version="v11.21.0" date="April 2, 2026" published="2026-04-02T15:22:13.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.21.0">
### Changes

## Features and Improvements
* Support paint properties in appearances
* Improve performance of View Annotations collisions test
* Share tile sources across style imports when URLs match
* Add UBO support for symbol paint properties
* Expose `MapboxMap.onStyleAttributionsChanged`

## Bug fixes 🐞
* Fix tile store eviction failing to clean up files for decompressed tiles, causing gradual storage growth.
* Fix gaps in elevated route line rendering at ramp transitions and tile borders.
* Fix indicator cutout (location puck area) appearing in the wrong position on high-DPI displays.
* Fix incorrect shadow culling on fill-extrusion layers.
* Fix ambient occlusion not being clipped when fill-extrusion layers are clipped by clip layers.
* Fix clip layer updates not always refreshing clipped layers and shadows.
* Fix feature cutout rendering artifacts on some devices caused by insufficient shader precision.
* Fix rendering of stacked underground 3D roads.
* Fix a crash that could occur when the map is destroyed during style loading.
* Fix underground road geometry being clipped in orthographic projection with small viewports.
* Fix map flickering caused by stencil buffer conflicts between raster and hillshade layers.
* Fix potential ANRs when receiving location updates under heavy system load.
* Internal fixes and performance improvements.


### Dependencies
* Update MapboxCommon to `24.21.0`.
* Update MapboxCoreMaps to `11.21.0`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.19.4" date="April 2, 2026" published="2026-04-02T15:03:18.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.19.4">
## Bug fixes 🐞

* Fix overscaled offline tilepack tiles being showed after switching to online mode

### Dependencies
* Update MapboxCommon to `24.19.4`.
* Update MapboxCoreMaps to `11.19.4`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.19.3" date="April 1, 2026" published="2026-04-01T16:35:25.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.19.3">
### Changes

Improved stability.

### Dependencies
* Update MapboxCommon to `24.19.3`.
* Update MapboxCoreMaps to `11.19.3`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.19.2" date="March 26, 2026" published="2026-03-26T10:50:18.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.19.2">
### Changes

- TileStore: prevent stray files after decompression failures and cancellation
- Fix eviction query to handle empty BLOB content

### Dependencies
* Update MapboxCommon to `24.19.2`.
* Update MapboxCoreMaps to `11.19.2`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.20.2" date="March 26, 2026" published="2026-03-26T10:23:59.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.20.2">
### Changes

- Fix eviction query to handle empty BLOB content
- TileStore: prevent stray files after decompression failures and cancellation 

### Dependencies
* Update MapboxCommon to `24.20.2`.
* Update MapboxCoreMaps to `11.20.2`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.18.3" date="March 26, 2026" published="2026-03-26T09:54:58.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.18.3">
### Changes

- TileStore: prevent stray files after decompression failures and cancellation
- TileStore: Fix eviction query to handle empty BLOB content

### Dependencies
* Update MapboxCommon to `24.18.3`.
* Update MapboxCoreMaps to `11.18.3`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.21.0-rc.1" date="March 26, 2026" published="2026-03-26T09:40:13.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.21.0-rc.1">
### Changes

## New Features

* Expose `MapboxMap.onStyleAttributionsChanged`

## Bug fixes 🐞
* Fix feature cutout shader precision issue
* Fix rendering of stacked underground 3d roads
* Fix crash in `onSpriteLoaded` callback
* Fix far-plane clipping of underground road geometry in orthographic projection 

## Improvements
* Support paint properties in appearances
* Improve performance of View Annotations collisions test
* Share tile sources across style imports when URLs match
* Add UBO support for symbol paint properties
* Fix map flickering due to manual clears of stencil after setupStencilForOverlap


### Dependencies
* Update MapboxCommon to `24.21.0-rc.1`.
* Update MapboxCoreMaps to `11.21.0-rc.1`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.20.1" date="March 18, 2026" published="2026-03-18T10:46:23.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.20.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.20.2 or any version from 11.21.0 onward.
>**This specific bug is only relevant to users who use tilestore offline regions.**

### Changes

* Internal fixes and performance improvements

### Dependencies
* Update MapboxCommon to `24.20.1`.
* Update MapboxCoreMaps to `11.20.1`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Release version="v11.20.0" date="March 13, 2026" published="2026-03-13T14:29:53.000Z" url="https://github.com/mapbox/mapbox-maps-ios/releases/tag/v11.20.0">
>[!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.20.2 or any version from 11.21.0 onward.
>**This specific bug is only relevant to users who use tilestore offline regions.**

> 📦 Pre-built binaries for faster build times are available via [mapbox-maps-ios-binary](https://github.com/mapbox/mapbox-maps-ios-binary/releases/tag/v11.20.0).

### Bug fixes 🐞

- **Map ornaments positioning**
Fix incorrect positioning of map ornaments when multiple ornaments are placed in the same corner. (@evil159)                            
- **Feature Cutout Artifacts at Route Overlaps** 
Fixed feature cutout artifacts caused by a shader caching issue at route overlaps, preventing visual artifacts where routes intersect. (@lasselammi)
- **FillExtrusion Data Race**
Fixed a data race condition where two threads could simultaneously write to a shared static variable in FillExtrusion layer rendering. (@zmiao)
- **Runtime Symbol Appearance Switches**
Fixed several issues related to runtime symbol appearance switches: active appearance was not recalculated when appearance order or conditions changed, text appearances were skipped when an image was active, only the first of multiple layers sharing the same source had appearances recalculated, and new layouts after relayout did not trigger appearance recalculation. (@woodroof)
- **Icon Visibility After Memory Reduction**
Fixed disappearing icons after reducing memory use. The vector icon manager now correctly clears its cache on `reduceMemoryUse`, restoring previous behavior. (@Nelarius)
- **Landmark POI Image Relayout**
Fixed an issue where landmark POI image loads triggered unnecessary relayout for unrelated layers, improving rendering performance and stability. (@mpulkki-mapbox)
- **TileStore Eviction Blocking**
Fixed TileStore eviction logic that could block the TileStore thread completely. Added a configurable cooldown delay between eviction calls and introduced over-eviction to reduce the frequency of eviction operations. (@olegfedorovdev)
- **Elevated Line Out-of-Bounds Clipping**
Fixed an out-of-bounds issue for elevated lines caused by an incorrect clipping result producing zero-length segments. (@metalpavel)
### Dependencies
* Update MapboxCommon to `24.20.0`.
* Update MapboxCoreMaps to `11.20.0`.

### Dependency requirements:
* Compatible version of Xcode: `16.2`

</Release>

<Pagination page="1" total-pages="5" total-items="100" next="https://releases.sh/mapbox/mapbox-maps-ios.md?page=2" />