NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #326 most downloaded on pub.dev
Flutter plugin for Cloud Firestore, a cloud-hosted, noSQL database with live synchronization and offline support on Android and iOS.
Latest stable
7.2.0
Last release 6 days ago
16 Nov 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
9 years old
297 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Update a dependency to the latest release.
Update a dependency to the latest release.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
FIX(firestore): fix an issue that would cause FieldValue.increment to not work for big int (#12426).
FIX(firestore,windows): fix compilation issue on Windows (#12375).
FIX(firestore,web): Propagate FirebaseException properly, fix mergeFields bug, fix bytesLoaded different type under different conditions (#12334).
FirebaseException properly, fix mergeFields bug, fix bytesLoaded different type under different conditions (#12334). (fdde75b0)AggregateField type to users (#12305). (2b83defa)not-in & in filters in the same query (#12307). (e538338c)average() is null when collection is empty or collection doesn't exist or the property doesn't exist on docs (#12304). (4d3b578d)FIX(firestore,web): fix an issue where nested object could be incorrectly decoded from JSObjects (#12289).
FIX(firestore,web): fix an issue where nested object could be incorrectly decoded from JSObjects (#12272).
FIX(core): bump Firebase C++ SDK to 13.13.1 (4.x backport, Windows Firestore security fix) (#18868).
Note: This is a security release for Cloud Firestore on iOS and macOS. Firebase iOS SDK 12.19.3 removes compromised eMudhra CA roots from Firestore's embedded gRPC root-certificate bundle (firebase-ios-sdk#16930). CocoaPods and Swift Package Manager both now use 12.19.3.
- Swift Package Manager: upgrade to this
firebase_corerelease.- CocoaPods: upgrade to this release, or patch immediately by adding
$FirebaseSDKVersion = '12.19.3'at the top ofios/Podfileand runningpod update FirebaseFirestore. If you also usefirebase_analyticsorfirebase_app_check, upgrade them as well: older versions requireFirebaseAnalytics/FirebaseAppCheck12.19.3, which was not published.- Windows: the Firebase C++ SDK is also affected and will be fixed in a follow-up
firebase_corerelease.
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v6.10.1cloud_functions - v6.5.1firebase_analytics - v12.6.1firebase_app_check - v0.4.9firebase_app_installations - v0.4.5firebase_auth - v6.7.1firebase_core - v4.15.1firebase_crashlytics - v5.4.1firebase_database - v12.6.1firebase_in_app_messaging - v0.9.5firebase_messaging - v16.7.1firebase_ml_model_downloader - v0.4.6firebase_performance - v0.11.7firebase_remote_config - v6.7.1firebase_storage - v13.6.1FIX(core): bump Firebase iOS SDK to 12.19.3 (4.x backport, Firestore security fix) (#18861).
FEAT(core): bump Firebase iOS SDK to 12.19.0 (#18683).
null cannot be used for isEqualTo or isNotEqualTo in a query. (#12164). (cff6f767)setSettings to allow usage of a up-to-date persistence on web (#12041). (c9174334)REFACTOR(core,android): migrate native implementation to Kotlin (#18570).
transaction.get() should throw FirebaseException on exception. (#12064). (3cfc5019)LoadBundleTaskState in cloud_firestore (#12065). (97903034)sum and average aggregated queries (#11757). (82af6c2f)FIX(firestore): revert changes to isLessThan, isLessThanOrEqualTo,isGreaterThan, isGreaterThanOrEqualTo & arrayContains. null is not valid.. (#12017).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX(firestore): allow null value to isEqualsTo & isNotEqualsTo in where() query (#11896).
FIX(firestore,android): fix a race condition that could cause a crash when adding event channels while closing the app (#11881).
FIX(firestore,core,windows): per-engine BinaryMessenger, Firestore/Auth link order, Profile builds (#18516).
FIX(firestore,android): cacheSizeBytes value cannot be null when setting persistenceEnabled (#11794).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
FIX: pass analyze and format on Flutter 3.50 (#18950).
FEAT(messaging): add FID registration APIs (#18482).
FEAT(messaging,android): improve how messaging is determining permission on Android (#18101).
Update a dependency to the latest release.
FIX(firestore): allow DocumentReference to be used to in Filter queries (#11593).
FIX(cloud_firestore): Fix crashes on iOS/macOS (#11501).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v6.5.0cloud_firestore_web - v5.5.0firebase_auth - v6.5.2firebase_auth_platform_interface - v9.0.2firebase_core - v4.10.0firebase_core_web - v3.8.0firebase_messaging - v16.3.0firebase_messaging_platform_interface - v4.8.0firebase_messaging_web - v4.2.0firebase_ai - v3.12.2firebase_data_connect - v0.3.0+3firebase_auth_web - v6.2.2_flutterfire_internals - v1.3.72cloud_firestore_platform_interface - v8.0.2cloud_functions - v6.3.2cloud_functions_platform_interface - v6.0.2cloud_functions_web - v5.1.8firebase_analytics - v12.4.2firebase_analytics_platform_interface - v6.0.2firebase_analytics_web - v0.6.1+8firebase_app_check - v0.4.4+2firebase_app_check_platform_interface - v0.4.0+2firebase_app_check_web - v0.2.4+3firebase_app_installations - v0.4.2+3firebase_app_installations_platform_interface - v0.1.4+71firebase_app_installations_web - v0.1.7+8firebase_crashlytics - v5.2.3firebase_crashlytics_platform_interface - v3.8.23firebase_database - v12.4.2firebase_database_platform_interface - v0.4.0+2firebase_database_web - v0.2.7+9firebase_in_app_messaging - v0.9.2+3firebase_in_app_messaging_platform_interface - v0.2.5+23firebase_ml_model_downloader - v0.4.2+3firebase_ml_model_downloader_platform_interface - v0.1.5+23firebase_performance - v0.11.4+2firebase_performance_platform_interface - v0.2.0+2firebase_performance_web - v0.1.8+8firebase_remote_config - v6.5.2firebase_remote_config_platform_interface - v3.0.2firebase_remote_config_web - v1.10.9firebase_storage - v13.4.2firebase_storage_platform_interface - v6.0.2firebase_storage_web - v3.11.8Packages 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_ai - v3.12.2firebase_data_connect - v0.3.0+3firebase_auth_web - v6.2.2_flutterfire_internals - v1.3.72cloud_firestore_platform_interface - v8.0.2cloud_functions - v6.3.2cloud_functions_platform_interface - v6.0.2cloud_functions_web - v5.1.8firebase_analytics - v12.4.2firebase_analytics_platform_interface - v6.0.2firebase_analytics_web - v0.6.1+8firebase_app_check - v0.4.4+2firebase_app_check_platform_interface - v0.4.0+2firebase_app_check_web - v0.2.4+3firebase_app_installations - v0.4.2+3firebase_app_installations_platform_interface - v0.1.4+71firebase_app_installations_web - v0.1.7+8firebase_crashlytics - v5.2.3firebase_crashlytics_platform_interface - v3.8.23firebase_database - v12.4.2firebase_database_platform_interface - v0.4.0+2firebase_database_web - v0.2.7+9firebase_in_app_messaging - v0.9.2+3firebase_in_app_messaging_platform_interface - v0.2.5+23firebase_ml_model_downloader - v0.4.2+3firebase_ml_model_downloader_platform_interface - v0.1.5+23firebase_performance - v0.11.4+2firebase_performance_platform_interface - v0.2.0+2firebase_performance_web - v0.1.8+8firebase_remote_config - v6.5.2firebase_remote_config_platform_interface - v3.0.2firebase_remote_config_web - v1.10.9firebase_storage - v13.4.2firebase_storage_platform_interface - v6.0.2firebase_storage_web - v3.11.8FIX(firestore): allow FieldPath.documentId as a field argument in queries (#11443).
FIX(firestore): remove assertion for arrayContainsAny & whereIn query combined (#11342).
FIX(firestore): allow 30 conjunctive & disjunctive queries for "in" & "array-contains-any" via where() API (#11265).
withConverter and returning null from fromFirestore (#11224). (4dd0f3f0)Filter.or() & Filter.and() (#11140). (e1f0064d)FIX(firestore,apple): issue where setting persistence caused a crash. kFIRFirestoreCacheSizeUnlimited no longer usable. (#11174).
FIX(firestore): update deprecated persistence API (#11069).
FEAT(messaging,web): add support for custom service worker script path in getToken method (#18290).
FIX(auth,android): Fix crash on Android where detaching from engine (#11296).
FEAT(core): bump Firebase Android SDK to 34.12.0 (#18185).
FIX(core): bump Firebase C++ SDK to 13.5.0 (CMake deprecation fix) (#18071).
FIX(firestore,ios): clean up event listeners on engine detach only (#10579).
REFACTOR: add verify to QueryPlatform and change internal verifyToken API to verify (#9711).
FIX(firestore): ensure all index URLs are captured and passed to the user (#10674).
FEAT(core,windows): update C++ Desktop SDK to 13.4.0. This may require updating your Visual Studio version and C++ build tools. (#18006).
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: bump firebase_core_platform_interface version to fix previous release.
firebase_core_platform_interface version to fix previous release. (bea70ea5)Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v3.2.0cloud_firestore_odm - v1.0.0-dev.19cloud_firestore_odm_generator - v1.0.0-dev.19cloud_functions - v3.3.0firebase_app_check - v0.0.6+15firebase_app_installations - v0.1.1firebase_auth - v3.4.0firebase_auth_platform_interface - v6.3.0firebase_auth_web - v3.3.18firebase_core - v1.19.0firebase_dynamic_links - v4.3.0firebase_ml_model_downloader - v0.1.1firebase_performance - v0.8.1firebase_storage - v10.3.0flutterfire_ui - v0.4.2+1firebase_in_app_messaging - v0.6.0+17firebase_in_app_messaging_platform_interface - v0.2.1+9firebase_crashlytics - v2.8.3firebase_crashlytics_platform_interface - v3.2.9firebase_remote_config - v2.0.10firebase_remote_config_web - v1.0.15firebase_remote_config_platform_interface - v1.1.9firebase_database_web - v0.2.0+16firebase_database - v9.0.17firebase_database_platform_interface - v0.2.1+9firebase_dynamic_links_platform_interface - v0.2.3+5cloud_firestore_web - v2.6.18cloud_firestore_platform_interface - v5.5.9firebase_app_installations_web - v0.1.0+16firebase_app_installations_platform_interface - v0.1.1+9firebase_messaging_web - v2.4.3firebase_messaging - v11.4.3firebase_messaging_platform_interface - v3.5.3firebase_analytics_platform_interface - v3.1.9firebase_analytics - v9.1.11firebase_analytics_web - v0.4.0+16firebase_ml_model_downloader_platform_interface - v0.1.1+9firebase_app_check_platform_interface - v0.0.4+9firebase_app_check_web - v0.0.5+15cloud_functions_web - v4.2.17cloud_functions_platform_interface - v5.1.9firebase_storage_web - v3.2.18firebase_storage_platform_interface - v4.1.9firebase_performance_platform_interface - v0.1.1+9firebase_performance_web - v0.1.0+15Packages 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_in_app_messaging - v0.6.0+17firebase_in_app_messaging_platform_interface - v0.2.1+9firebase_crashlytics - v2.8.3firebase_crashlytics_platform_interface - v3.2.9firebase_remote_config - v2.0.10firebase_remote_config_web - v1.0.15firebase_remote_config_platform_interface - v1.1.9firebase_database_web - v0.2.0+16firebase_database - v9.0.17firebase_database_platform_interface - v0.2.1+9firebase_dynamic_links_platform_interface - v0.2.3+5cloud_firestore_web - v2.6.18cloud_firestore_platform_interface - v5.5.9firebase_app_installations_web - v0.1.0+16firebase_app_installations_platform_interface - v0.1.1+9firebase_messaging_web - v2.4.3firebase_messaging - v11.4.3firebase_messaging_platform_interface - v3.5.3firebase_analytics_platform_interface - v3.1.9firebase_analytics - v9.1.11firebase_analytics_web - v0.4.0+16firebase_ml_model_downloader_platform_interface - v0.1.1+9firebase_app_check_platform_interface - v0.0.4+9firebase_app_check_web - v0.0.5+15cloud_functions_web - v4.2.17cloud_functions_platform_interface - v5.1.9firebase_storage_web - v3.2.18firebase_storage_platform_interface - v4.1.9firebase_performance_platform_interface - v0.1.1+9firebase_performance_web - v0.1.0+15Update a dependency to the latest release.
FEAT(android): migrate plugins to built-in Kotlin on Flutter 3.44 (#18922).
REFACTOR: upgrade project to remove warnings from Flutter 3.7 (#10344).
FIX: fix crash that could occur when using transactions (#10184).
> Note: This is a security release for Cloud Firestore on Windows. Firebase C++ SDK 13.13.1 builds Firestore from Firebase iOS SDK 12.19.3, which remo…
Note: This is a security release for Cloud Firestore on Windows. Firebase C++ SDK 13.13.1 builds Firestore from Firebase iOS SDK 12.19.3, which removes compromised eMudhra CA roots from Firestore's embedded gRPC root-certificate bundle (firebase-ios-sdk#16930).
- Windows: upgrade to this
firebase_corerelease (orcloud_firestore6.10.2, which requires it). If the build keeps using the old SDK, runflutter clean. If you setFIREBASE_CPP_SDK_DIR, point it at a 13.13.1 SDK.- iOS/macOS were fixed in
firebase_core4.15.1 (BoM 4.20.1).
Packages with breaking changes:
Packages with other changes:
FIX(core,appcheck,web): start when the browser blocks web storage (#18946).
FIX(core,web): honour flutterfire_ignore_scripts under dart2wasm (#18806).
Update a dependency to the latest release.
FIX: fix aggregated count to use the current query and not only the collection on Web (#9824).
FIX(firestore,web): ensure exact same streams are not unsubscribed (#13032).
DOCS(firebase_remote_config): add documentation what is returned when the key does not exist for getBool, getInt, getDouble and getString (#10573).
FIX(firestore,web): ensure streams are removed on "hot restart" (#12913).
FIX(core,web): skip hot-restart listener cleanup in profile mode (#18729).
FIX: fix a query error in Flutter Web that was affecting the parsing of ancient dates (#9633).
FEAT: bump Firebase JS SDK to 12.9.0 (#18043).
One column per quarter.