NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #1108 most downloaded on pub.dev
Official Mapbox Maps SDK for Flutter. Add an interactive map widget that renders Mapbox Vector Tile (MVT) maps. Customize it for Android, iOS, and Web.
Latest stable
3.34.2
Last release 19 days ago
03 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 59 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
4 years old
191 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Update Mapbox Maps SDK to v11.26.0-alpha.1
Update Mapbox Maps SDK to v11.25.3
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update Mapbox Maps SDK to v11.25.2
Update Mapbox Maps SDK to v11.25.1
Deprecate MapboxMap.onTapListener and MapboxMap.onLongTapListener in favor of the MapboxMap.addInterfaction API.
MapboxMap.onTapListener and MapboxMap.onLongTapListener in favor of the MapboxMap.addInterfaction API.MapboxMap.httpService.setMaxRequestsPerHost to cap the number of concurrent HTTP requests per host issued by the underlying HTTP service. Useful for reducing the chance of hitting per-token rate limits during offline tile region downloads.Update Mapbox Maps SDK to v11.25.0-rc.2
Deprecate MapboxMap.onTapListener and MapboxMap.onLongTapListener in favor of the MapboxMap.addInterfaction API.
MapboxMap.onTapListener and MapboxMap.onLongTapListener in favor of the MapboxMap.addInterfaction API.MapboxMap.httpService.setMaxRequestsPerHost to cap the number of concurrent HTTP requests per host issued by the underlying HTTP service. Useful for reducing the chance of hitting per-token rate limits during offline tile region downloads.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update Mapbox Maps SDK to v11.24.3
Update Mapbox Maps SDK to v11.24.2
Add TileStore.setOptionForKey to allow setting custom tile store options by arbitrary string key, in addition to the existing predefined options (disk
TileStore.setOptionForKey to allow setting custom tile store options by arbitrary string key, in addition to the existing predefined options (diskQuota, mapboxApiUrl, tileUrlTemplate).Add TileStore.setOptionForKey to allow setting custom tile store options by arbitrary string key, in addition to the existing predefined options (disk
TileStore.setOptionForKey to allow setting custom tile store options by arbitrary string key, in addition to the existing predefined options (diskQuota, mapboxApiUrl, tileUrlTemplate).Add TileStore.setOptionForKey to allow setting custom tile store options by arbitrary string key, in addition to the existing predefined options (disk
TileStore.setOptionForKey to allow setting custom tile store options by arbitrary string key, in addition to the existing predefined options (diskQuota, mapboxApiUrl, tileUrlTemplate).Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update Mapbox Maps SDK to v11.23.1
Deprecate MapWidget.cameraOptions in favor of the viewport API — existing usage still works but will be removed in next major version; migrate camera…
[!NOTE]
There is a known crash when calling
TileStore.createAton Android. This will be addressed in v2.24.0-rc.1.
MapWidget.cameraOptions in favor of the viewport API — existing usage still works but will be removed in next major version; migrate camera initialization and updates to the viewport API. // Before
MapWidget(
cameraOptions: CameraOptions(
center: Point(coordinates: Position(-117.918976, 33.812092)),
zoom: 15.0,
),
);
// After
MapWidget(
viewport: CameraViewportState(
center: Point(coordinates: Position(-117.918976, 33.812092)),
zoom: 15.0,
),
);
MapWidget.onTapListener and MapWidget.onLongTapListener in favor of the MapboxMap.addInteraction API — tap/long-tap handlers will be removed in next major version; migrate to the Interactions API for richer feature-aware handling. // Before
MapWidget(
onTapListener: (context) {
print('Tapped at ${context.point}');
},
onLongTapListener: (context) {
print('Long-tapped at ${context.point}');
},
);
// After — on the map itself
mapboxMap.addInteraction(TapInteraction.onMap((context) {
print('Tapped at ${context.point}');
}));
mapboxMap.addInteraction(LongTapInteraction.onMap((context) {
print('Long-tapped at ${context.point}');
}));
MapWidget.cameraOptions in favor of the viewport API.MapWidget.onTapListener and MapWidget.onLongTapListener in favor of the MapboxMap.addInteraction API.Deprecate MapWidget.cameraOptions in favor of the viewport API — existing usage still works but will be removed in next major version; migrate camera…
MapWidget.cameraOptions in favor of the viewport API — existing usage still works but will be removed in next major version; migrate camera initialization and updates to the viewport API. // Before
MapWidget(
cameraOptions: CameraOptions(
center: Point(coordinates: Position(-117.918976, 33.812092)),
zoom: 15.0,
),
);
// After
MapWidget(
viewport: CameraViewportState(
center: Point(coordinates: Position(-117.918976, 33.812092)),
zoom: 15.0,
),
);
MapWidget.onTapListener and MapWidget.onLongTapListener in favor of the MapboxMap.addInteraction API — tap/long-tap handlers will be removed in next major version; migrate to the Interactions API for richer feature-aware handling.
Other gesture listeners (scroll, zoom, etc.) are unaffected. // Before
MapWidget(
onTapListener: (context) {
print('Tapped at ${context.point}');
},
onLongTapListener: (context) {
print('Long-tapped at ${context.point}');
},
);
// After — on the map itself
mapboxMap.addInteraction(TapInteraction.onMap((context) {
print('Tapped at ${context.point}');
}));
mapboxMap.addInteraction(LongTapInteraction.onMap((context) {
print('Long-tapped at ${context.point}');
}));
Update Mapbox Maps SDK to v11.22.4
Update Mapbox Maps SDK to v11.22.3
Update Mapbox Maps SDK to v11.22.1
Update Mapbox Maps SDK to v11.22.0
Update Mapbox Maps SDK to v11.22.0-rc.1
Nothing published for this version
Update Mapbox Maps SDK to v11.21.11
Update Mapbox Maps SDK to v11.21.10
Update Mapbox Maps SDK to v11.21.9
Update Mapbox Maps SDK to v11.21.8
Nothing published for this version
Update Mapbox Maps SDK to v11.21.6
Update Mapbox Maps SDK to v11.21.5
Update Mapbox Maps SDK to v11.21.4
Update Mapbox Maps SDK to v11.21.3
Update Mapbox Maps SDK to v11.21.2
Update Mapbox Maps SDK to v11.21.1
Update Mapbox Maps SDK to v11.21.0
Update Mapbox Maps SDK to v11.21.0-rc.1
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
TileStore: prevent stray files after decompression failures and cancellation
>A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to unco
[!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 2.20.1 or any version from 2.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.
shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.LineLayer.lineElevationGroundScale property to scale elevated lines with terrain exaggeration.LineLayer.lineZOffset and LineLayer.lineElevationReference.ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.FollowPuckViewportState.padding to control camera padding when following the user's location puck, allowing the puck to be offset from the viewport center (e.g. for navigation UIs where the puck should appear near the bottom of the screen).Add experimental shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the gr
shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.LineLayer.lineElevationGroundScale property to scale elevated lines with terrain exaggeration.LineLayer.lineZOffset and LineLayer.lineElevationReference.ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.FollowPuckViewportState.padding to control camera padding when following the user's location puck, allowing the puck to be offset from the viewport center (e.g. for navigation UIs where the puck should appear near the bottom of the screen).TileStore: prevent stray files after decompression failures and cancellation
>A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to unco
[!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 2.19.2, 2.20.1 or any version from 2.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.
SDK_REGISTRY_TOKEN is not set in the environment or gradle.properties.customData not being applied when updating Circle, Point, Polygon, and Polyline annotations.> Android builds may fail with a SDK_REGISTRY_TOKEN property error. Please upgrade to 2.19.1.
[!NOTE]
Android builds may fail with aSDK_REGISTRY_TOKENproperty error. Please upgrade to 2.19.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 2.19.2, 2.20.1 or any version from 2.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.
Update Mapbox Maps SDK to v11.19.0-rc.1
Update Mapbox Maps SDK to v11.19.0-beta.1
TileStore: prevent stray files after decompression failures and cancellation
>A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to unco
[!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 2.18.1, 2.19.2, 2.20.1 or any version from 2.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.
deleteMulti() method to all annotation managers to enable batch deletion of annotations.> Known Issue - Android Memory Usage: This beta release contains a memory usage issue on Android that may cause increased memory consumption during ma
[!IMPORTANT] Known Issue - Android Memory Usage: This beta release contains a memory usage issue on Android that may cause increased memory consumption during map usage sessions. This issue will be addressed in the upcoming stable release.
deleteMulti() method: All annotation managers now support efficient batch deletion of multiple annotations, improving performance when removing large numbers of annotations at once.> Version numbering has been updated to align with Mapbox's cross-platform SDK versioning scheme. We skipped from 2.12.0 to 2.17.0 to synchronize with
[!NOTE] Version numbering has been updated to align with Mapbox's cross-platform SDK versioning scheme. We skipped from 2.12.0 to 2.17.0 to synchronize with other Mapbox SDKs, ensuring consistent version numbers across all platforms.
ModelLayer to stable.SymbolLayer.iconColorBrightnessMax, SymbolLayer.iconColorBrightnessMin, SymbolLayer.iconColorContrast, SymbolLayer.occlusionOpacityMode, FillExtrusionLayer.fillExtrusionCastShadows, RasterArraySource.volatile, and PolylineAnnotation.lineEmissiveStrength properties.LineLayer.lineCutoutOpacity from 0 to 1.0.customData field to annotations to be able to pass user data.LineLayer.lineCutoutOpacity, and LineLayer.lineCutoutFadeWidth from layout to paint.[!NOTE] Version numbering has been updated to align with Mapbox's cross-platform SDK versioning scheme. This release skips from 2.12.0 to 2.17.0 to synchronize with other Mapbox SDKs (version x.17.0), ensuring consistent version numbers across all platforms.
ModelLayer to stable.SymbolLayer.iconColorBrightnessMax, SymbolLayer.iconColorBrightnessMin, SymbolLayer.iconColorContrast, SymbolLayer.occlusionOpacityMode, FillExtrusionLayer.fillExtrusionCastShadows, RasterArraySource.volatile, and PolylineAnnotation.lineEmissiveStrength properties.LineLayer.lineCutoutOpacity from 0 to 1.0.customData field to annotations to be able to pass user data.LineLayer.lineCutoutOpacity, and LineLayer.lineCutoutFadeWidth from layout to paint.compileSdk to 35 on Android.> Version numbering has been updated to align with Mapbox's cross-platform SDK versioning scheme. We skipped from 2.12.0 to 2.17.0-beta.1 to synchroni
[!NOTE] Version numbering has been updated to align with Mapbox's cross-platform SDK versioning scheme. We skipped from 2.12.0 to 2.17.0-beta.1 to synchronize with other Mapbox SDKs, ensuring consistent version numbers across all platforms.
customData field to annotations to be able to pass user data.LineLayer.lineCutoutOpacity, LineLayer.lineCutoutWidth, and LineLayer.lineCutoutFadeWidth from layout to paint.One column per quarter.