NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #447 most downloaded on pub.dev
Flutter plugin for Firebase Cloud Storage, a powerful, simple, and cost-effective object storage service for Android and iOS.
Latest stable
14.0.1
Last release 22 days ago
23 Oct 2026
Ships on a steady schedule
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
229 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
REFACTOR: migrate from hash* to Object.hash* (#8797).
README.md files (#8814). (78006e0d)DOCS: use camel case style for "FlutterFire" in README.md (#8752).
README.md (#8752). (5c5dcaf1)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update a dependency to the latest release.
Update a dependency to the latest release.
Packages with breaking changes:
Tasks.call() API from android. (#8421). (461bba5a)Packages with breaking changes:
Packages with other changes:
cloud_firestore_odm - v1.0.0-dev.13cloud_firestore_odm_generator - v1.0.0-dev.13firebase_analytics - v9.1.6firebase_auth - v3.3.15firebase_core - v1.15.0firebase_dynamic_links - v4.2.0firebase_dynamic_links_platform_interface - v0.2.3firebase_messaging_platform_interface - v3.3.0flutterfire_ui - v0.4.0+3firebase_crashlytics - v2.6.3firebase_in_app_messaging_platform_interface - v0.2.1+4firebase_in_app_messaging - v0.6.0+12firebase_crashlytics_platform_interface - v3.2.4firebase_remote_config - v2.0.5firebase_remote_config_web - v1.0.10firebase_auth_web - v3.3.13firebase_database_web - v0.2.0+11firebase_auth_platform_interface - v6.2.4firebase_remote_config_platform_interface - v1.1.4firebase_database - v9.0.12firebase_database_platform_interface - v0.2.1+4cloud_firestore - v3.1.13cloud_firestore_platform_interface - v5.5.4cloud_firestore_web - v2.6.13firebase_app_installations_web - v0.1.0+11firebase_app_installations - v0.1.0+11firebase_analytics_platform_interface - v3.1.4firebase_analytics_web - v0.4.0+11firebase_app_installations_platform_interface - v0.1.1+4firebase_messaging - v11.2.14firebase_messaging_web - v2.2.12firebase_ml_model_downloader_platform_interface - v0.1.1+4firebase_ml_model_downloader - v0.1.0+11firebase_app_check_platform_interface - v0.0.4+4cloud_functions_web - v4.2.12firebase_app_check - v0.0.6+10cloud_functions_platform_interface - v5.1.4cloud_functions - v3.2.13firebase_app_check_web - v0.0.5+10firebase_storage_platform_interface - v4.1.4firebase_storage_web - v3.2.13firebase_storage - v10.2.13firebase_performance_platform_interface - v0.1.1+4firebase_performance_web - v0.1.0+10firebase_performance - v0.8.0+10Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
firebase_crashlytics - v2.6.3firebase_in_app_messaging_platform_interface - v0.2.1+4firebase_in_app_messaging - v0.6.0+12firebase_crashlytics_platform_interface - v3.2.4firebase_remote_config - v2.0.5firebase_remote_config_web - v1.0.10firebase_auth_web - v3.3.13firebase_database_web - v0.2.0+11firebase_auth_platform_interface - v6.2.4firebase_remote_config_platform_interface - v1.1.4firebase_database - v9.0.12firebase_database_platform_interface - v0.2.1+4cloud_firestore - v3.1.13cloud_firestore_platform_interface - v5.5.4cloud_firestore_web - v2.6.13firebase_app_installations_web - v0.1.0+11firebase_app_installations - v0.1.0+11firebase_analytics_platform_interface - v3.1.4firebase_analytics_web - v0.4.0+11firebase_app_installations_platform_interface - v0.1.1+4firebase_messaging - v11.2.14firebase_messaging_web - v2.2.12firebase_ml_model_downloader_platform_interface - v0.1.1+4firebase_ml_model_downloader - v0.1.0+11firebase_app_check_platform_interface - v0.0.4+4cloud_functions_web - v4.2.12firebase_app_check - v0.0.6+10cloud_functions_platform_interface - v5.1.4cloud_functions - v3.2.13firebase_app_check_web - v0.0.5+10firebase_storage_platform_interface - v4.1.4firebase_storage_web - v3.2.13firebase_storage - v10.2.13firebase_performance_platform_interface - v0.1.1+4firebase_performance_web - v0.1.0+10firebase_performance - v0.8.0+10Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: Fix UploadTask.cancel() so that it completes when called. (#8417).
UploadTask.cancel() so that it completes when called. (#8417). (19ee62c3)Update a dependency to the latest release.
FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184).
Update a dependency to the latest release.
FIX(database,apple): ensure platform channel is invoked on main thread (#11650).
Update a dependency to the latest release.
FIX: bump Android compileSdkVersion to 31 (#7726).
compileSdkVersion to 31 (#7726).Packages with breaking changes:
unnecessary_import analyzer issues introduced with Flutter 2.8.Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
flutterfire_ui - v0.2.0+2Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FEAT: update dependency constraints to sdk: '>=2.18.0 <4.0.0' flutter: '>=3.3.0' (#10946).
FEAT: bump dart sdk constraint to 2.18 (#10618).
FirebaseApp instances from Dart (#6549).Update a dependency to the latest release.
FIX: cache the result of event.snapshot to be able to compare the value (#9899).
TARGET_OS_OSX (#7116).FIX: remove https port number from downloadUrl for iOS (#7097).
downloadUrl for iOS (#7097).FIX: fix localhost url parsing for Storage Emulator (#7003).
REFACTOR: add verify to QueryPlatform and change internal verifyToken API to verify (#9711).
Update a dependency to the latest release.
FIX: reinstate deprecated emulator apis (#6626).
BREAKING FEAT: Firebase iOS SDK version: 10.0.0 (#9708).
Note: This release has breaking changes.
mappedHost instead of host (#6539).Bump platform interface a major version due to pigeon dependency update
Bump platform interface a major version due to pigeon dependency update
REFACTOR: move all packages to workspace (#18182). (6cdfcb10)
FIX: update core, auth and app-check logic so internal resources on method channels are properly disposed (#18268). (a0de4ed8)
FEAT(auth,android): add revokeAccessToken support for Android (#18206) (#18207). (7e0a2227)
Note: This release has breaking changes.
Update a dependency to the latest release.
FIX: refFromUrl parse url (#6353).
REFACTOR(core,android): migrate native implementation to Kotlin (#18570).
FIX(cloud_firestore): stop dropping filters, settings and instance on copies (#18819).
useEmulator (#5936).FIX(firestore,android): clean up Android transaction listeners on completion (#18475).
FIX: secondary storage buckets now work as expected on Web (#5863).
DOCS(cloud_firestore): Remove Incorrect API Documentation (#18423).
FIX: improve refFromURL http regex (#5682).
Update a dependency to the latest release.
REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
List values would error on transaction result (#7001).Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v6.7.0cloud_firestore_platform_interface - v8.0.4cloud_firestore_web - v5.7.0cloud_functions_platform_interface - v6.0.4firebase_ai - v3.14.0firebase_auth - v6.5.5firebase_core - v4.12.0cloud_functions - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cloud_functions - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Update a dependency to the latest release.
REFACTOR: Migrate Firebase Storage to nnbd (#4753).
REFACTOR(firestore): deprecate setIndexConfigurationFromJSON (#18801).
Note: This release has breaking changes.
FIX(apple): build on Firebase Apple SDK 13 and require macOS 11 for Swift packages (#18783).
FIX(crashlytics,android): fix an issue with deobfuscating flavored builds (#18085).
com.android.tools.build & 'com.google.gms:google-services versions (#4269).FIX(firebaseai): add useLimitedUseAppCheckTokens flag to instance cache keys (#18826).
FIX(firestore,macos): add Nonull decorator to PigeonParser to remove warnings when building (#12930).
FEAT(firebaseai): Deprecated candidateCount, temperature, topP, topK, `presence… (#18694).
candidateCount, temperature, topP, topK, `presence… (#18694). (2c1e26fb)FEAT: bump compileSdkVersion to 29 (#3975).
CHORE: delete package_config.json (#3744).
FIX: if custom metadata value returns null put value as empty string.
…on-going tasks easier. There are a number of breaking changes & features with this overhaul:
As part of our on-going work for #2582 this is our Firebase Storage rework changes.
Overall, Firebase Storage has been heavily reworked to bring it inline with the federated plugin setup along with adding new features, documentation and many more unit and end-to-end tests (tested on Android, iOS & MacOS).
FirebaseStorage
FirebaseStorage.instanceFor or FirebaseStorage.instance instead.getReferenceFromUrl() is deprecated in favor of calling ref() with a path.getMaxOperationRetryTimeMillis() is deprecated in favor of the getter maxOperationRetryTime.getMaxUploadRetryTimeMillis() is deprecated in favor of the getter maxUploadRetryTime.getMaxDownloadRetryTimeMillis() is deprecated in favor of the getter maxDownloadRetryTime.setMaxOperationRetryTimeMillis() is deprecated in favor of setMaxUploadRetryTime().setMaxUploadRetryTimeMillis() is deprecated in favor of setMaxUploadRetryTime().setMaxDownloadRetryTimeMillis() is deprecated in favor of setMaxDownloadRetryTime().ref() creates a new Reference at the bucket root, whereas an optional path (ref('/foo/bar.png')) can be used to create a Reference pointing at a specific location.refFromURL, which accepts a Google Storage (gs://) or HTTP URL and returns a Reference synchronously.Reference
StorageReference has been renamed to Reference.getParent() is deprecated in favor of .parent.getRoot() is deprecated in favor of .root.getStorage() is deprecated in favor of .storage.getBucket() is deprecated in favor of .bucket.getPath() is deprecated in favor of .fullPath.getName() is deprecated in favor of .name.list(options).
ListOptions API (see below).listAll().putString() has been added to accept a string value, of type Base64, Base64Url, a Data URL or raw strings.
Content-Type metadata if not already set.getData() does not require a maxSize, it can now be called with a default of 10mb.NEW ListOptions
list() method accepts a ListOptions instance with the following arguments:
maxResults: limits the number of results returned from a call. Defaults to 1000.pageToken: a page token returned from a ListResult - used if there are more items to query.NEW ListResult
ListResult class has been added, which is returned from a call to list() or listAll(). It exposes the following properties:
items (List<Reference>): Returns the list of reference objects at the current reference location.prefixes (List<Reference>): Returns the list of reference sub-folders at the current reference location.nextPageToken (String): Returns a string (or null) if a next page during a list() call exists.Tasks
StorageUploadTask has been renamed to UploadTask (extends Task).StorageDownloadTask has been renamed to DownloadTask (extends Task).StorageTaskEvent has been removed (see below).StorageTaskSnapshot has been renamed to TaskSnapshot.pause(), cancel() and resume() are now Futures which return a boolean value to represent whether the status update was successful.
void methods but still carried out an asynchronous tasks, potentially leading to uncaught exceptions.isCanceled, isComplete, isInProgress, isPaused and isSuccessful have now been removed. Instead, you should subscribe to the stream (for paused/progress/complete/error events) or the task Future for task completion/errors.TaskSnapshot now provides the latest TaskState via task.snapshot.state.events stream (now snapshotEvents) previously returned a StorageTaskEvent, containing a StorageTaskEventType and StorageTaskSnapshot Instead, the stream now returns a TaskSnapshot which includes the state.FirebaseException instead of a new event.events stream is deprecated in favor of snapshotEvents.lastSnapshot is deprecated in favor of snapshot.The new Tasks API matches the Web SDK API, for example:
UploadTask task = FirebaseStorage.instance.ref('/notes.text').putString('My notes!');
// Optional
task.snapshotEvents.listen((TaskSnapshot snapshot) {
print('Snapshot state: ${snapshot.state}'); // paused, running, complete
print('Progress: ${snapshot.totalBytes / snapshot.bytesTransferred}');
}, onError: (Object e) {
print(e); // FirebaseException
});
// Optional
task
.then((TaskSnapshot snapshot) {
print('Upload complete!');
})
.catchError((Object e) {
print(e); // FirebaseException
});
Subscribing to Stream updates and/or the tasks delegating Future is optional - if you require progress updates on your task use the Stream, otherwise the Future will resolve once its complete. Using both together is also supported.
FIX(firestore,web): ensure streams are removed on "hot restart" (#12913).
FIX(core,web): skip hot-restart listener cleanup in profile mode (#18729).
firebase_core.firebase_core.firebase_core.Nothing published for this version
Update lower bound of dart dependency to 2.0.0.
REFACTOR: fix all unnecessary_import analyzer issues introduced with Flutter 2.8.
unnecessary_import analyzer issues introduced with Flutter 2.8.cloud_firestore_odm_generator - v1.0.0-dev.5DOCS: update firestore dartpad example.
FIX(auth,windows): fix a crash that could happen when using sendEmailVerification or sendPasswordResetEmail (#12946).
FEAT: bump Firebase JS SDK to 12.2.1 (#17678).
StorageFileDownloadTask and added propagation of errors to the Future returned by the writeToFile method in StorageReference.One column per quarter.